Контрагентио API – это SaaS-сервис для автоматического получения сведений о российских организациях (ЮЛ и ИП) и проявления должной осмотрительности при выборе контрагентов.
- Базовый URL для методов API расположен по адресу https://api.kontragent.io/v3/graphql
- Обмен данными с сервисом осуществляется по протоколу HTTPS.
- Формат данных запроса – GraphQL.
- Формат данных ответа – JSON.
- Параметры в запроса должны быть в кодировке UTF-8 и закодированы для передачи в URL (http://en.wikipedia.org/wiki/Percent-encoding).
С точки зрения технологий работа с языком запросов GraphQL ничем не отличается от работы с обычным REST API, но если вы не знакомы с GraphQL, то рекомендуем ознакомиться со следующими материалами:
- Introduction to GraphQL (англ.) – официальный вводный курс от разработчика.
- Что же такое этот GraphQL? – перевод статьи Sacha Greif "Что же такое этот GraphQL?" на Habrahabr
Для доступа к методам сервиса требуется передавать аутентификационный JWT-токен в заголовке Authorization по схеме Bearer (при работе с песочницей токен необходимо указать в поле "Токен авторизации"). Для получения токена напишите нам на sales@kontragent.io.
Для того, чтобы вам было удобнее тестировать свои запросы, мы подготовили специальную песочницу, которая расположена по адресу https://sandbox.kontragent.io. Песочница позволяет использовать средства автокомплита, автоматической валидации и форматирования запросов. Для получения подсказок по возможным полям запроса нажмите Shift + Пробел или Ctrl + Пробел.
Чтобы запросить данные у GraphQL API из вашей информационной системы, вам достаточно отправить POST-запрос. Пример простого запроса, который получит полное наименование для организации с ОГРН 1047796788930 с помощью CURL:
curl -X POST \
-H "Content-Type: application/json" \
-H "Authorization: Bearer YOUR-API-TOKEN-HERE" \
-d '
{
"query": "query someRandomQueryName($ogrn: String) { company(ogrn: $ogrn) { fullName } }",
"variables": {
"ogrn": "1047796788930"
},
"operationName": "someRandomQueryName"
}
' \
https://api.kontragent.io/v3/graphql
Полная документация ко всем методам расположена в песочнице. Для того, чтобы получить сведения об интересующих данных, нажмите на вкладку Docs в правом верхнем углу экрана.
Далее приведены ссылки на примеры получения некоторых данных:
- Поиск по российским организациям и ИП
- Карточка российской организации
- Карточка индивидуального предпринимателя
- Печатные формы отчетов
- Сертификаты и лицензии
- Риски
- Банкротства и существенные факты
- Исполнительные производства
- Проверки
- Изменения в ЕГРЮЛ/ЕГРИП
- Картотека Арбитражных Дел
Для получения токена доступа к API напишите нам на sales@kontragent.io По вопросам работы с API обращайтесь на support@kontragent.io
- Добавлены Сертификаты и лицензии
- Добавлены Риски
- Добавлены Банкротства и существенные факты
- Добавлены Исполнительные производства
- Добавлены Проверки
- Добавлены Изменения в ЕГРЮЛ/ЕГРИП
- Добавлена Картотека Арбитражных Дел
- Обновлена документация
- Добавлены печатные формы отчетов
- Обновлена документация