Создание запросов к API
Для работы c API необходимо отправить POST или GET запрос по адресу http://smmka.ru/api.php. Все запросы необходимо отправлять только с серверной стороны.
Пример
Пример
Ответ предоставляется в формате JSON.
Методы API
Метод test_url
test_url - проверка url кампании перед созданием кампании
Параметры Описание Значения
social Социальная сеть social=vk - социальная сеть Вконтакте.
social=fb - социальная сеть Facebook.
type_adv Тип кампании type_adv=0 - группа Вконтакте, публичная страница Вконтакте, встреча Вконтакте, публичная страница Facebook.
type_adv=1 - «Мне нравится» Вконтакте.
type_adv=3 - друзья и подписчики на личную страницу Вконтакте.
url url кампании При передаче url GET запросом, необходимо кодировать url (php – функция urlencode)
Пример
Ответ предоставляется в формате JSON.
Ответ Значения
status "ok" - url верный
"ОШИБКА" - url неверный, возвращает описание ошибки
Пример
Метод add_adv
add_adv - создание новой кампании
Параметры Описание Значения
social Социальная сеть social=vk - социальная сеть Вконтакте.
social=fb - социальная сеть Facebook.
type_adv Тип кампании type_adv=0 - группа Вконтакте, публичная страница Вконтакте, встреча Вконтакте, публичная страница Facebook.
type_adv=1 - «Мне нравится» Вконтакте.
type_adv=3 - друзья и подписчики на личную страницу Вконтакте.
url url кампании При передаче url GET запросом, необходимо кодировать url (php – функция urlencode)
sex Пол sex=0 - любой.
sex=1 - женский.
sex=2 - мужской.
zone Страна, город zone=0 - любой.
zone=1 - Россия.
zone=2 - Украина.
zone=3 - Москва.
zone=4 - Санкт-Петербург.
zone=5 - Киев.
years Возраст years=0 - любой.
years=1 - от 18 лет.
years=2 - до 18 лет.
offers Количество оффер Количество выполнивших кампанию. Целое положительное число.
Пример
Ответ предоставляется в формате JSON.
Ответ Значения
status "ok" - кампания успешно добавлена
"ОШИБКА" - кампания не добавлена, возвращает описание ошибки
adv_id возвращает номер кампании
Пример
Метод get_stat
get_stat - получение статистики кампании
Параметры Описание Значения
social Социальная сеть social=vk - социальная сеть Вконтакте.
social=fb - социальная сеть Facebook.
id_adv Номер кампании Номер кампании для получения статистики
Пример
Ответ предоставляется в формате JSON.
Ответ Значения
status "ok" - статистика успешо получена
"ОШИБКА" - статистика не получена, возвращает описание ошибки
url Возвращает url кампании.
type_adv type_adv=0 - группа Вконтакте, публичная страница Вконтакте, встреча Вконтакте, публичная страница Facebook.
type_adv=1 - «Мне нравится» Вконтакте.
type_adv=3 - друзья и подписчики на личную страницу Вконтакте.
offers Возвращает заказанное количество оффер.
now_offers Возвращает количество выполненных оффер.
status_adv status_adv=0 - кампания проверяется.
status_adv=1 - кампания выполняется.
status_adv=2 - кампания приостановлена
status_adv=-1 - кампания заблокирована
Пример
smmka.class.php
PHP класс для работы с api. Для работы необходимо создать файл smmka.class.php со следующим содержимым.
Код
Пример вызова класса
smmka.ru - ООО "СММ"   Правила