Подключение к API

Модель взаимодействия

API использует модель RESTful (данные передаются в виде объектов JSON). Особенностью является использование партнером и Cardsmobile двух интерфейсов:

• Push API — используется партнером для отправки push-сообщений;

• Callback API — используется Cardsmobile для передачи информации о доставке и прочтении сообщений.

Параметры подключения

Авторизация запросов

Взаимодействие осуществляется по протоколу HTTPS. Для авторизации запросов к Push API необходимо использовать HTTP Basic Authentication (RFC 7617). Данные для авторизации запросов передаются в HTTP-заголовке "Authorization".

Требования к кодировкам

Как в запросах, так и в ответах используется кодировка UTF-8.

Коды HTTP

В случае успешного выполнения запроса, со стороны узла Cardsmobile будет возвращен тип данных, описанный в документации запроса, и HTTP-код 200.

В случае ошибки обработки запроса будет возвращен один из HTTP-кодов с описанием ошибки в теле ответа в формате JSON:

Примеры тела ошибки:

{
    "status": "BAD_REQUEST",        // статус HTTP ошибки
    "errors": [                     // массив ошибок
        "msisdn: size must be between 0 and 10000", // описание ошибки
        "subId: may not be null"
    ]
}

{
    "status": "UNAUTHORIZED",
    "errors": [
        "Auth token is invalid"
    ]
}