Методы API

Общие понятия

Взаимодействие с SailPlay API построено на HTTP/HTTPS-запросах. Все параметры передаются в формате GET (POST)-запросов. В ответ всегда возвращается данные в формате json.

Для повышения уровня безопасности передаваемых данных, мы рекомендуем использоваться HTTPS-запросы к API-методам. При этом все https-запросы должны быть адресованы строго к домену "sailplay.ru".

 

В дальнейшем будем использовать следующие понятия:

  • Транзакция - любое действие, связанное с начислением/списание бонусных баллов у пользователя, с использованием API (в т.ч. покупкивыдача подарковначисление бонусных баллов).

  • Токен (token) - уникальный идентификатор сессии. Используется в авторизации партнера в системе SailPlay. Более подробно см. здесь.

  • PIN-код (пин-код)  - числовой код, используется в некоторых запросах к API SailPlay (например в авторизации). Целевое назначение - разделение частей системы партнера, для построения дальнейшей аналитики. Более подробно см. здесь

  • Номер заказа (order_num) - главный идентификатор заказа для синхронизации заказов в вашей системе и в SailPlay. SailPlay не накладывает никаких ограничений на формат данного параметра. Более подробно см. здесь

  • Идентификатор клиента - идентификатор клиента, по которому происходит сопоставление клиентов в вашей системе и в SailPlay. Идентификатором клиента может служить номер телефона, e-mail или origin_user_id (ID пользователя в вашей системе). Более подробно см. здесь