API и интеграция

Сайт vkserfing.ru предоставляет доступ к функциям сайта для заказчиков посредством API. Для получения доступа к функциям сайта выполняется GET или POST запрос, где в качестве обязательного параметра должен передаваться token, ключ доступа к API, который предоставляется по запросу в тех. поддержку.

Например, для редактирования заказа и присвоения заказу статус "На паузе" потребуется выполнить следующий запрос:

https://vkserfing.ru/api/campaign.edit?token=a56a7e1c5358ee0c14c0e58d992da436&id=285259&status=pause

Смотря на запрос мы можем разбить его на следующие составляющие:

https://vkserfing.ru/api/ Базовый URL запроса, куда должны идти все вызовы
campaign.edit Вызываемый метод, где campaign - название ресурса, edit - метод ресурса.
token API-ключ, полученный у тех. поддержки
id и status Параметры вызываемого метода, в данном случае это ID редактируемого заказа и присваеваемый статус

Итого мы можем выделить основные составляющие запроса:

https://vkserfing.ru/api/[resource].[method]?token=[api_key]

В случае успешного выполнения, ответ будет выглядеть следующим образом:

 { status: 'success', data: "[data]" } 

В противном случае, придет следующее:

{ status: 'error', error: { code: "[code]", message: "[message]" } }
[code] Код ошибки
[message] Сообщение, описывающие эту самую ошибку
Методы
Campaign заказы
Метод Описание
campaign.add Создание заказа
campaign.edit Редактирование заказа
campaign.get Список всех заказов
campaign.getById Информация о заданном заказе
campaign.logs Список пользователей выполнивших задание
Project папки проектов
Метод Описание
project.add Создание папки
project.edit Редактирование папки
project.delete Удаление папки
project.get Список всех папок
User пользователь
Метод Описание
user.balance Текущий баланс
Util вспомогательные методы
Метод Описание
util.getCountries Список стран
util.getCities Список городов
Ошибки

Ошибки делятся на 2 типа: общие и ошибки, характерные только для определенного метода. Ошибки методов будут представлены на странице оных, общие ошибки описаны здесь.

Код ошибки Описание
TOKEN_NOT_EXIST Переданный API ключ не существует
TOKEN_NOT_PASSED Не передан API ключ
TOKEN_BANNED_OWNER Владелец API ключа заблокирован
ARGUMENT_NOT_PASSED Не передан обязательный параметр
METHOD_NOT_EXIST Запрашиваемого метода не существует
RECORD_NOT_EXIST Запись с запрашиваемым ID не существует
NOT_ENOUGH_MONEY Недостаточно средств на балансе
EXTERNAL_ERROR Внешняя ошибка
DATABASE_ERROR Ошибка базы данных
SERVER_ERROR Ошибка сервера