Служба для машин

Те же ответы, что видит человек, в форме, которую читает программа: типизированные отказы, словарь значений, отпечаток источника и границы вывода в каждом ответе. Краткое описание в открытом формате: /llms.txt.

Точки входа

Проверка: GET /v1/counterparty/{унп}?name=…. Живой запрос к реестру; без ключа для юридических лиц; name — наименование из ваших документов, будет сверено. Ответ JSON, ключи русские.
Карточка по УНП: GET /v1/public/by-unp/{унп}: что уже собрано, без обращения к реестру, мгновенно. Каждое утверждение — с держателем, моментом снятия, sha256 ответа и полем attribution; удержанное названо в withheld.
Страница организации: https://ai-belarus.by/org/{унп}: постоянный адрес, HTML с разметкой schema.org (Organization, WebPage), собранный сервером; только юридические лица.
Поиск: GET /v1/public/search?q=…: по УНП или названию среди собранного. По названию находятся только юридические лица.
Карта сайта: /sitemap.xml: все открытые страницы организаций.
MCP: https://ai-belarus.by/mcp — streamable HTTP, без ключа: lookup_company, search_companies, check_counterparty. Имя в реестре MCP — by.ai-belarus/registry. Те же ворота права, что у открытого API.
Действия GPT: /openapi-gpt.json: спецификация только открытых путей — вставляется в редактор GPT как есть.
Словарь ответа: /v1/meta/vocabulary: поля, три исхода, измеренные состояния реестра.
Охват и права: /v1/meta/coverage: сколько в базе, какие источники, что показывать вправе, коды отказов.
Спецификация: /openapi.yaml, выгружается из кода при каждом выпуске.
Список: POST /v1/counterparty/batch, до 50 УНП, только по ключу клиента; состояние задания по GET /v1/counterparty/batch/{job_id}.
Подпись пакетов: /v1/meta/signing-key: открытый ключ Ed25519 для проверки аудит-пакетов.

Правила

Три исхода. Поля существует и действует принимают да, нет, не_установлено. Третий исход никогда не сводится к первым двум: реестр не ответил, состояние не измерено или показывать нельзя.
Темп. Живая проверка — не больше 60 запросов в минуту с адреса, открытые карточки и поиск — 30; ответ 429 означает «подождите». Живая проверка идёт к реестрам с паузой и занимает секунды; повтор того же УНП в течение 10 минут отвечает запомненным ответом держателя, и момент его настоящего получения стоит в поле доказательство.получено.
Отказы. application/problem+json по RFC 9457 с полями code и retryable. Любая вина клиента остаётся 4xx; 5xx означает поломку у нас.
Доказательство. Каждый ответ несёт держателя, адрес запроса, момент и sha256 сырого ответа реестра. Ответ можно сверить независимо, запросив реестр тем же адресом.
Удержанное названо. Поля, которые реестр прислал, но показывать вам их права нет, перечислены с причиной. Молчаливого усечения нет.
Распространение дальше. Сведения при передаче третьим лицам обязаны называть обладателя и распространителя (Закон 455-З, статья 20); реквизиты приходят в поле attribution.

Границы

Чего служба не делает

Об индивидуальных предпринимателях показывает только ФИО и только тому, кто уже знает УНП (одиночная проверка, решение оператора OD-IP-NAME-PUBLIC-REGISTRY); остальные поля закрыты, по имени предприниматель не ищется, открытой страницы у него нет. Не ищет по названию в государственном реестре: реестр отвечает только по УНП, по названию служба ищет в своей базе. Не даёт оценок, баллов, рекомендаций и не хранит ключи доступа в открытом виде.

Пример

curl -s "https://ai-belarus.by/v1/counterparty/100316761?name=ОАО%20МТЗ"

Ответ: ответ.существует = да, ответ.действует = да, наименование, адрес, состояние словами реестра, сверка_с_вашими_документами.совпало, доказательство.отпечаток_ответа_держателя, ответ.закупки (участие в государственных закупках по собранным пакетам ГИАС: роли, счёт, последние записи; ноль записей значит «в нашей базе нет», не «не участвовал»), ответ.банкротство (дела по Единому реестру сведений о банкротстве в момент запроса: исход, стадия, номер дела, управляющий), ответ.недопуск_к_закупкам (список временно не допускаемых поставщиков ГИАС: исход, дата включения, основание), ответ.плановые_проверки (планы выборочных проверок КГК: исход, полугодие, орган, месяц).