Машиночитаемые данные о компаниях Беларуси: JSON, Markdown и API
Каждая страница цифрового паспорта изначально спроектирована как машиночитаемый источник данных. Интегрируйте проверку контрагентов и обогащение карточек в свои CRM, скрипты и ИИ-агенты.
Сводная таблица открытых эндпоинтов
| Метод и эндпоинт | Формат ответа | Назначение | Лимит частоты |
|---|---|---|---|
GET /api/v1/companies?q={query} | JSON | Поиск организаций по названию, домену или УНП | 60 в минуту |
GET /api/v1/companies/{unp} | JSON | Полный профиль компании со всеми проверенными фактами | 60 в минуту |
GET /{slug}.md | Markdown | Текстовый документ с YAML-шапкой для LLM и парсеров | Стандартный |
GET /{slug}.json | JSON | Структурированная карточка с полным графом Schema.org | Стандартный |
| GET /llms.txt | Текст UTF-8 | Сводный индекс платформы по стандарту llms.txt | Без ограничений |
| GET /llms-full.txt | Текст UTF-8 | Полный сводный корпус паспортов для обучения и индексации | Без ограничений |
POST /api/mcp | JSON-RPC 2.0 | Интерфейс Model Context Protocol для вызова инструментов агентами | 60 в минуту |
| GET /.well-known/openapi.json | OpenAPI 3.1 | Спецификация всех REST-эндпоинтов для кодогенерации | Без ограничений |
Примеры запросов и согласование формата ответа
Карточки компаний поддерживают стандартное согласование содержимого через HTTP-заголовки. Данные адаптированы под требования поиска в нейросетях и проверены в нашем открытом бенчмарке 200 запросов:
Получение профиля в формате Markdown через заголовок Accept:
curl -H "Accept: text/markdown" https://digitalpassport.by/693338772-arobotiks-inzhiniringПолучение чистого JSON по УНП:
curl https://digitalpassport.by/api/v1/companies/693338772Подключение MCP-сервера в конфигурацию ИИ-ассистента:
{
"mcpServers": {
"digitalpassport": {
"url": "https://digitalpassport.by/api/mcp"
}
}
}Структура объекта компании в JSON API
| Поле | Тип данных | Описание |
|---|---|---|
unp | string, 9 цифр | Учётный номер плательщика Республики Беларусь |
short_name | string | Краткое официальное наименование юрлица с ОПФ |
full_name | string | Полное наименование организации по выписке ЕГР |
brand_name_en | string или null | Латинский алиас бренда и города для англоязычных систем |
status_label | string | Статус плательщика в ГРП МНС — «Действующий» |
verification_level | string | Уровень верификации: registry, domain_verified, owner_verified, cases_verified |
claims | array | Список проверенных фактов с указанием источника и даты сверки |
services | array | Перечень конкретных подтверждённых услуг и специализаций |
Частые вопросы об API и машиночитаемых форматах
Какие форматы машиночитаемых данных поддерживаются из коробки?
Платформа предоставляет данные в форматах JSON (REST API и .json), Markdown (.md и заголовок Accept: text/markdown), JSON-LD (микроразметка Schema.org), индексах llms.txt и llms-full.txt, а также по протоколу Model Context Protocol (MCP JSON-RPC 2.0).
Нужен ли API-ключ для базовых запросов к публичному REST API?
Для публичных GET-запросов к API компаний по УНП API-ключ не требуется. Действует стандартный лимит частоты обращений в рамках открытого доступа.
Как подключить ИИ-агента к платформе через протокол MCP?
Укажите URL эндпоинта https://digitalpassport.by/api/mcp в конфигурации вашего MCP-клиента — Claude Desktop, Cursor или Goose. Файл обнаружения инструментов доступен по адресу https://digitalpassport.by/.well-known/mcp.json.
Какие действуют лимиты на частоту обращений к API?
Для публичного REST API и MCP-эндпоинта действует ограничение 60 запросов в минуту с одного IP-адреса. Для поиска по сайту действует лимит 30 запросов в минуту.