Все о компаниях и владельцах

Структура данных

Структура данных

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

Чтобы выполнить запрос, авторизуйтесь на api.sbis.ru. После этого можно передавать API-команды сервиса.

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

Чтобы передать запрос на сервер, в заголовке запроса обязательно укажите:

  • адрес запроса:
    • для аутентификации — https://api.sbis.ru/auth/service/
    • выполнения команд — https://api.sbis.ru/spp-rest-api/service/
  • идентификатор сессии (SID) — 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" — объект, который содержит ответ на команду.

Если произошла ошибка, то в HTTP-заголовке вернется код ошибки, а в поле «error» — ее текст.

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

Поиска компании по ИНН 7712040126.

POST https://api.sbis.ru/spp-rest-api/service/ 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",
   "method": "SppAPI.Requisites",
   "params": {
      "inn": "7712040126",
      "ogrn": null
   },
   "protocol": 4,
   "id": 0
}

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

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
}