Основная информация API
API GlobalSMM работает на базе технологии REST. Для обеспечения легкости и низкого входящего порога в качестве HTTP-метода мы используем только GET/POST запросы, а уведомления об ошибках возвращаются в теле ответа.
В каждом запросе Вам нужно передавать токен в опции с именем "access_token" GET-параметром. При удачном запросе Вам вернётся объект, который имеет поле "success" с значение true. Если произошла ошибка - будет значение false. Данные по ошибке/ответ хранятся в поле "data".
Пример удачного ответа на запрос:
{ "success": true, "data": { "status": "processing" } }
Пример неудачного ответа на запрос:
{ "success": false, "data": { "name": "Unauthorized", "message": "Your request was made with invalid credentials.", "code": 0, "status": 401, } }
Формат ответа
Данные возвращаются в форматах XML, JSON. Для получения формата можно задать его явно в заголовке:
Accept: application/json Accept: application/xml
Либо добавить параметр _format
и в нём указать нужный желаемый ответ.
Аутентификация
Для аутентификации используется access_token, который передается в теле запроса. Свой токен Вы можете найти на странице настроек.
Токен генерируется после регистрации, и действует бессрочно до тех пор, пока его не изменит
пользователь/администрация.
Внимание! Не передавайте Ваш токен третьим лицам, во избежание несанкционированного доступа к
данным.
Версирование
Мы используем версирование для обеспечения стабильной работы клиентского кода независимо от изменений.
Для работы с определенной версией указывайте её в URL. На данный момент существующая верися API - v1.
http://global-smm.ru/api/v1/
Ошибки/пожелания
Если у Вас есть пожелания к функциональности API или Вы заметили ошибку - пожалуйста, обратитесь в техническую поддержку. Будем рады исправить ошибки, а также ответить на вопросы и помочь Вам.