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

Cardsmobile Place Info API - Previous

Синхронизация списка точек обслуживания

Next - Cardsmobile Check-In API

Общие сведения

Last modified 18d ago

Copy link

Contents

post

Cинхронизация списка точек обслуживания

get

Запрос статуса обработки списка