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

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

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

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

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

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

  • для аутентификации — https://api.saby.ru/auth/service/
  • выполнения команд — https://api.saby.ru/vok/

«Token» и «sid» — обязательные поля для обмена данными по API. С их помощью внешнее приложение выполняет запросы в СБИС. При выполнении запроса передайте значение одного из этих полей в заголовках.

Заголовок

Описание

X-SBISAccessToken: <access_token>

Токен доступа внешнего приложения

X-SBISSessionId:<sid>

Идентификатор сессии, в которой запрашивается доступ

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

Обмен с API происходит по url «https://api.sbis.ru/vok/». Метод и параметры описаны в отдельном документе. Во все запросы передавайте заголовки.

Добавьте метод к адресной строке. Например, если нужны реквизиты — «https://api.sbis.ru/vok/req». После этого напишите параметры запроса. Например, для получения данных о компании «Газпром» — «https://api.sbis.ru/vok/req?inn=7736050003».

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

Сервер СБИС возвращает ответ в формате JSON.

Массовые запросы

Массовыми считаются все методы, кроме:

  • поисковых;
  • методов событий;
  • методов, отдающих файлы;
  • статистики по запросам клиента.

Максимальное количество реквизитов — 20. Единовременно можно подавать только один тип реквизитов — ИНН или ОГРН.

Количество запросов вычисляется из количества реквизитов.

КПП можно передать вместе с ИНН. В таком случае расположите их в начале списка реквизитов до одиночных ИНН.

Формат ответа

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

Поиск владельцев по ИНН 7605016030

Поиск реквизитов по ИНН 7605016030

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

Данные владельцев

Реквизиты

Нашли неточность? Выделите текст с ошибкой и нажмите ctrl + enter.