Документация для внешних агентов
Стабильный публичный контракт — префикс /api/agent/v1. Остальные URL API сайта предназначены для веб-приложения; совместимость для сторонних агентов на них не заявляется. Подробности схемы запросов — в OpenAPI по ссылке ниже.
Discovery
- Каталог API (linkset): https://uslugi-tut.by/.well-known/api-catalog
- Корень agent API (JSON): https://service.uslugi-tut.by/api/agent/v1
- Описание операций (OpenAPI 3): https://service.uslugi-tut.by/api/agent/v1/openapi.json
- Дополнительные указатели (в т. ч. служебные) перечислены в каталоге по первой ссылке.
Handoff: стать исполнителем
Онбординг исполнителя выполняется только в продукте. Агент передаёт пользователю ссылку (и при необходимости поясняет шаги), отдельного «создать исполнителя по API» в контракте нет.
Стать исполнителем →Заявка исполнителю (lead)
POST https://service.uslugi-tut.by/api/agent/v1/executors/{id}/callback-request
{id} — тот же числовой идентификатор, что в публичном URL профиля исполнителя. Поля тела и ограничения — в OpenAPI. Оформление полноценного заказа от имени пользователя в этот контракт не входит.
Использование
Доступ и объёмы использования регулируются правилами площадки и отдельными договорённостями с партнёрами. Технические вопросы интеграции вне этого описания — через контакты на сайте.