Russian
Cardsmobile Loyalty Online API
Cardsmobile Loyalty Offline Service
Cardsmobile TOTP Service
Cardsmobile Place Info API
Cardsmobile Check-In API
Cardsmobile Push API
Cardsmobile Promo API
Кошелёк Pay API
Cardsmobile Digital Product Delivery API
Cardsmobile Tokenization SDK
Cardsmobile Gift Cards Offline Service
Бизнес-сценарии приложения «Кошелёк»
Запросы API
Для синхронизации списка точек обслуживания
post
https://<base-URL>
/places/sync
Cинхронизация списка точек обслуживания
Структура тела запроса:
1
{
2
"places": [ // список точек обслуживания
3
{
4
"itemId": "string", // идентификатор точки обслуживания в информационной системе партнера
5
"placeInfo": { // информация о точке обслуживания
6
"name": "string", // название точки обслуживания
7
"address": "string", // адрес точки обслуживания
8
"phones": [ // телефон(ы) точки обслуживания
9
{
10
"type": "string",
11
"number": "string"
12
}
13
],
14
"schedule": "string", // режим работы
15
"metroStations": [ // ближайшие станции метро
16
"string"
17
],
18
"type": "string", // тип точки обслуживания
19
"geoPoint": { // координаты точки обслуживания
20
"lat": 0, // географическая широта
21
"lng": 0 // географическая долгота
22
}
23
}
24
}
25
]
26
}
Copied!
- Поле
addressявляется обязательным. - Где применимо, текстовые данные должны передаваться на русском языке в кодировке UTF-8.
Параметры ответа
Узел Cardsmobile в ответе вернет партнеру идентификатор сессии синхронизации
sessionId — это означает, что обработка переданного партнером списка началась.get
https://<base-URL>
/places/sync/{sessionId}
Запрос статуса обработки списка
С какой периодичностью проверять статус обработки?
Окончанию обработки соответствует статус FINISHED. В среднем обработка списка занимает около минуты. Общая длительность обработки зависит от объема списка и количества изменений.
О позициях, содержащих ошибки:
В финальном ответе (
"status": "FINISHED") все обнаруженные ошибки обработки в случае их наличия будут переданы в массиве errors. Данные о точке обслуживания, содержащие ошибки, отбраковываются сервисом Cardsmobile — в этом случае партнер должен считать, что данные точки не были добавлены/обновлены, и должен прислать корректные данные при очередной синхронизации.