Сценарий: результат сборки в задаче
Ваш сервис может найти задачу по ключу, прочитать её состояние и добавить комментарий с результатом работы. Так история остаётся рядом с задачей, а внешней системе не нужен доступ к браузерной сессии пользователя.
Публичный базовый адрес — https://tracker.18d.ru/api/v1. Передавайте Authorization: Bearer TOKEN. Создайте токен в настройках 18дел и храните его в защищённых переменных вашей системы. API v1 принимает токены; одного cookie входа в браузере недостаточно.
Проверьте подключение
export TRACKER_TOKEN='YOUR_TOKEN'
curl 'https://tracker.18d.ru/api/v1/me' -H "Authorization: Bearer $TRACKER_TOKEN"
curl 'https://tracker.18d.ru/api/v1/queues' -H "Authorization: Bearer $TRACKER_TOKEN"Создайте задачу в доступной очереди
Сначала получите настоящий ID очереди из GET /queues. Число 42 ниже — вымышленный пример, а не ID вашей очереди. Для создания нужны права read-write или admin.
curl 'https://tracker.18d.ru/api/v1/issues' -H "Authorization: Bearer $TRACKER_TOKEN" -H 'Content-Type: application/json' -d '{"queue_id":42,"title":"Проверить релиз","priority":"high"}' Обрабатывайте конфликты и ограничения
При изменении задачи отправляйте её актуальную version. Ответ 409 означает, что запись уже изменилась: прочитайте её заново и пересмотрите изменение, а не повторяйте старый запрос бесконечно. 401 указывает на проблему с авторизацией, 403 — на недостаточные права; скрытый объект может возвращать 404.
Списки возвращаются JSON-массивами, отдельные записи — объектами. Поиск ограничен 2000 результатами. Доступ и авторство совпадают с MCP и интерфейсом; токен нельзя использовать для чтения другого пространства. Полный перечень методов, форматы ответов и ограничения приведены в документации.