Для обмена данными с сервером СБИС API сервиса «Все о компаниях» использует формат JSON. Данные передаются в виде HTTPS-запросов/ответов, кодировка — UTF-8, метод указан в описании.
Чтобы выполнить запрос, авторизуйтесь на api.sbis.ru. После этого можно передавать API-команды сервиса.
Заголовок запроса
Чтобы передать запрос на сервер, в заголовке запроса обязательно укажите адрес запроса:
- для аутентификации — https://api.sbis.ru/auth/service/
- выполнения команд — https://api.sbis.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
Пример ответа
Данные владельцев
Реквизиты