СТРУКТУРА ДАННЫХ

API-интерфейс сервиса «Все о компаниях» использует формат JSON-RPC  для обмена данными с сервером online.sbis.ru посредством HTTPS-запросов/ответов. Используемая кодировка – UTF-8, метод — POST.

Заголовок запроса

В заголовке передаваемого запроса обязательно указывается:

  • адрес сервера:
    • для аутентификации — https://online.sbis.ru/auth/service/
    • для поиска контрагента — https://online.sbis.ru/service/sbis-rpc-service300.dll
  • идентификатор сессии — Cookie: sid=00000273-00000273-00ba-5b200da509414e0b
  • кодировка символов — Content-Type: application/json; charset=utf-8
  • данные о вашей информационной системе — User-Agent: Python-urllib/3.3

Объект запроса

Объект запроса должен содержать:

  • значение "jsonrpc":"2.0", указывающее на версию спецификации JSON-RPC;

  • параметр "method" с названием команды;

  • параметр "params" с объектом передаваемых параметров команды;

  • параметр "id" со строковым значением.

Объект ответа

В ответ на запрос с сервера возвращается аналогичная JSON-структура:

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

Если произошла ошибка, в ответе на запрос должно появиться значение "error"

Пример запроса

Рассмотри пример поиска компании со следующими реквизитами: ИНН 7816475530 и КПП 781601001

POST http://online.sbis.ru/service/sbis-rpc-service300.dll HTTP/1.1
Accept-Encoding: identity
Connection: close
Cookie: sid=000ba0eb-000ba0ec-00ba-40fc5c46a4644bba
Content-Length: 168
Host: online.sbis.ru
User-Agent: Python-urllib/3.3
Content-Type: application/json; charset=utf-8
 
{
	"jsonrpc": "2.0",
	"protocol": 3,
	"method": "Контрагент.СписокСправочный",
	"params": {
		"ИНН": "7812014560",
		"КПП": "645545001"
	},
	"id": 1
}

Пример ответа

HTTP/1.1 200 OK
Date: Fri, 16 Sep 2016 06:24:02 GMT
Content-Type: application/json; charset=utf-8
Content-Length: 1020
Connection: close
Access-Control-Allow-Origin: *
X-Node: 78081
X-Uniq-ID: da3e373b-d515-441d-b23c-4d734dd03faf
X-Application-Task: 164617
X-Logic: online.sbis.ru:83
X-SPP-Router: online.sbis.ru
X-Path: (10.76.158.31:8088) (200); 10.76.162.246:83 200;
X-MS: spp-master
Cache-Control: must-revalidate, max-age=0
X-Dispatch: online.sbis.ru
X-Frame-Options: SAMEORIGIN
 
{
	"jsonrpc": "2.0",
	"result": {
		"s": [{"n": "ОГРН", "t": "Текст"}, 
                      {"n": "ИНН", "t": "Текст"}, 
                      {"n": "КПП", "t": "Текст"}, 
                      {"n": "Название","t": "Текст"}, 
                      {"n": "НормализованноеНазвание","t": "Текст"}, 
                      {"n": "ОКПО","t": "Текст"}, 
                      {"n": "ДатаРегистрации","t": "Дата"}, 
                      {"n": "ДатаЛиквидации","t": "Дата"}, 
                      {"n": "Адрес","t": "Текст"}, {"n": "Директор","t": "Текст"}, 
                      {"n": "РазбитыйАдрес","t": "Запись"}, 
                      {"n": "НазваниеПолное","t": "Текст"}],
		"d": [
			["1027809169585", 
                         "7812014560", 
                         "645545001", 
                         "Саратовское региональное отделение Поволжского филиала", 
                         "Саратовское региональное отделение Поволжского филиала", 
                         null, 
                         null, 
                         "2014-11-28", 
                         null, 
                         null, 
                         null, 
                         "Саратовское региональное отделение Поволжского филиала"]
		],
		"_type": "recordset"
	},
	"id": 1,
	"protocol": 3
}
1
1
Оставьте свой отзыв:
ОТПРАВИТЬ