qadesk.ru / ИИ-агенты · MCP

qadesk.ru / REST API

Интеграции

REST API: всё, что умеет кабинет, — по HTTP, и документация, которая не отстаёт от сервера

Документ OpenAPI 3.1 и Swagger UI собираются из кода сервера на каждый запрос — пути, тела, параметры и требование токена берутся из тех же контроллеров и схем, что обслуживают кабинет. Второго описания, которое могло бы разойтись с реальными ручками, у API нет.

# ключ — персональный токен из кабинета: Настройки → Интеграции → MCP
$ export QADESK_PAT=qdpt_…
 
# проекты пространства
$ curl -s https://api.qadesk.ru/api/v1/workspaces/$WS/projects \
    -H "Authorization: Bearer $QADESK_PAT"
[{"code":"QAD","name":"Портал", …}]
 
# завести дефект — ключ выдаст сервер
$ curl -s -X POST …/workspaces/$WS/bugs -d '{"projectId":"…","title":"…", …}'
{"key":"QAD-248","status":"new", …}
 
# токен другого пространства — не пустит, даже если вы там состоите
403 token_scope: персональный токен действует только в своём пространстве
Swagger UI с «попробовать»

api.qadesk.ru/api/docs — все ручки по разделам: дефекты, тест-кейсы, планы, прогоны, проекты, участники, интеграции. Кнопка Authorize принимает тот же токен. Документ отдельно: /api/openapi.json.

Один ключ для REST и ИИ-агентов

Персональный токен qdpt_… открывает и REST, и MCP. Он действует от вашего имени и в ваших правах — та же матрица ролей, что в кабинете, — и только в своём пространстве. Секрет показывается один раз, отзыв действует сразу.

Версия в пути, ошибки одной формы

/api/v1 живёт, пока есть кто-то, кто его зовёт; ломающее изменение выйдет как /api/v2. Любая ошибка — одно тело с кодом, сообщением и requestId, по которому запрос находится в журнале.

В коробке — то же самое, без интернета

Swagger UI отдаётся своими файлами, а не с CDN: в закрытом контуре документация та же, что в облаке. Отчёты автотестов идут не через REST, а через qadesk-cli с токеном приёма проекта.

Попробуйте QA Деск на своих процессах

Зарегистрируйтесь, выпустите токен в настройках — и первый запрос к API уйдёт через пару минут. Нужно живое демо на сценариях вашей команды — напишите нам.

Попробовать

Демо-проект с кейсами и дефектами · перенос кейсов из TestIT и CSV · внедрение силами команды Эм Си Арт