Формат протокола JSON-RPC в API

Протокол передачи между вашей информационной системой (ИС) и сервером использует json-формат, который поддерживает спецификацию JSON-RPC v2.0. Все дополнительные типы данных описываются отдельно, дополняя типы данных в спецификации.

Запросы должны выполняться с использованием кодировки UTF-8.

Объект запроса в JSON-RPC v2.0

По стандарту json-объект запроса должен содержать параметры:

• "jsonrpc" со значением"2.0", версия спецификации JSON-RPC;
• method со значением метода бизнес-логики;
• params с объектом передаваемых параметров;
• id со строковым или целочисленным значением.

Объект ответа в JSON-RPC v2.0

Json-объект ответа должен содержать значения:

• "jsonrpc" — версия спецификации JSON-RPC;
• id со строковым или целочисленным значением, аналогично объекту запроса;
• error — выводится при ошибке;
• result — результат выполнения методов. Не имеет четкого формата. Например, если метод вернул null, то в json-объекте ответа появится "result":null.

Объект ошибки в JSON-RPC v2.0

Объект ошибки содержит поля:

• code — целочисленный код ошибки;
• message — текстовое сообщение об ошибке;
• data — опциональный параметр, который в СБИС используется для передачи информации о типе исключения и трассировки места возникновения исключения с сервера на клиент;
• details — параметр, который не показывается пользователю в сообщении, но перед отправкой логируется именно это сообщение с подробным описанием причины проблемы.