API - общие положения

Общие положения

API предназначен для интеграции торговых систем клиента с сервисом HEADO и поддерживает JRPC 2.0-протокол вызова методов.

Методы API делятся на два раздела:

• Device API - для взаимодействия с устройством;
• Management API - для взаимодействия в рамках торговой сети.

Протокол обмена данными

Запрос представляет собой JSON-сериализованный объект отправляемый с помощью POST-метода в виде RAW_POST_DATA

1
2
3
4
5
6
7

{
                        "jsonrpc":"2.0",
                        "id": "[Свободно-генерируемый идентификатор запроса]"
                        "method": "[Название вызываемого метода]",
                        "params":  [объект или массив аргументов вызываемого метода]
                       }
                    }

Ответ так же является JSON-сериализованным объектом

1
2
3
4
5

{
                        "jsonrpc":"2.0",
                        "id":"[Идентификатор запроса на который дан ответ]"
                        "result":[Любой тип данных - объект, массив, значение]
                      }

или отрицательный

1
2
3
4
5
6
7
8

{
                        "jsonrpc":"2.0",
                        "id":"[Идентификатор запроса на который дан ответ]"
                        "error": {
                        "code":"[Код ошибки]",
                        "message":"[Человекочитаемое пояснение ошибки]"
                        }
                      }

Список ошибок

Требования к надежности потоков данных

Надежность потоков данных должна обеспечиваться комплексом организационно-технических мероприятий отладки, поиска и исключения ошибок, а также технологическими процедурами резервирования.

При реализации потоков данных должны обеспечиваться:

• защита от потери данных в условиях возможных сбоев и отказов канала передачи данных, доступности API HEADO;
• диагностика сбоев и отказа канала передачи данных и доступности API HEADO;
• протоколирование событий при передаче данных с возможностью последующего анализа причин возникновения критических ситуаций.

В качестве мер по повышению надежности потоков данных должны быть предусмотрены:

• мониторинг доступности API HEADO;
• отложенная передача данных в случае недоступности API HEADO (прогрессивная задержка повторной передачи, например: 0, 3, 30, 60 сек, и.т.д.);
• обработка ошибок, возвращаемых API HEADO;
• повторная отправка данных в случае наличия ошибок API HEADO;
• диагностика ошибок с помощью программных средств контроля.