API GlobalSMM работает на базе технологии REST. Для обеспечения легкости и низкого входящего порога в качестве HTTP-метода мы используем только GET/POST запросы, а уведомления об ошибках возвращаются в теле ответа.
В каждом запросе Вам нужно передавать токен в опции с именем "access_token" GET-параметром. При удачном запросе Вам вернётся объект, который имеет поле "success" с значение true. Если произошла ошибка - будет значение false. Данные по ошибке/ответ хранятся в поле "data".
Пример удачного ответа на запрос:
{
"success": true,
"data": {
"status": "Canceled"
}
}
Пример неудачного ответа на запрос:
{
"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 или Вы заметили ошибку - пожалуйста, обратитесь в техническую поддержку. Будем рады исправить ошибки, а также ответить на вопросы и помочь Вам.