Основное

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 или Вы заметили ошибку - пожалуйста, обратитесь в техническую поддержку. Будем рады исправить ошибки, а также ответить на вопросы и помочь Вам.