Версионированный публичный контракт
Основа API доступна под /api/v1. Ответы содержат данные и метаданные снимка: время получения, признак устаревшего кэша и версию API.
Подключение агента за один запрос
Ключ для публичного чтения не нужен. Агент может отфильтровать рынок, категорию, протокол, способ доступа и состояние адреса, а затем применить свою политику к отдельным полям ratingAverage, ratingCount, technicalScore, scoreCoverage, sourceUrl и lastCheckedAt.
Нулевое число отзывов не означает низкую оценку, а состояние адреса не описывает весь сервис. Используйте meta.fetchedAt и meta.stale, чтобы учитывать свежесть снимка.
GET https://agenttrusthub.cc/api/v1/services?market=russia&category=automation&availability=healthy&limit=20&sort=score
Основания вместо готового вердикта
API сохраняет происхождение записи, пользовательскую оценку, технический индекс и состояние адреса как отдельные поля. Неизвестные сведения остаются неизвестными, а состояние адреса не выдаётся за состояние всего сервиса.
Это позволяет приложению или агенту самостоятельно определить допустимый риск и показать пользователю, на каких данных основан выбор.
OpenAPI и обновления
Контракт описан в OpenAPI 3.1. Ответы только для чтения кэшируются на короткий срок и допускают запросы из браузерных клиентов. JSON API, RSS и сайт читают одну ленту, которая автоматически обновляется из разрешённых официальных источников; чувствительные темы остаются на модерации.
Что не входит в эту версию
В текущей публичной основе нет API-ключей, удалённого MCP, подписанных снимков, кошельков или платных проверок. Decision API и MCP будут строиться поверх одного детерминированного ядра отдельным релизом.