Russian
Запросы 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 — в этом случае партнер должен считать, что данные точки не были добавлены/обновлены, и должен прислать корректные данные при очередной синхронизации.
Last modified 18d ago