Интеграции

Ошибки API, фильтры и безопасные повторы

Как обрабатывать отказы без потери данных и случайных дублей.

Статусы ошибок

401: токен отсутствует, неверен, отозван либо пользователь отключён.
403: объект доступен для просмотра, но действие не разрешено.
404: объект отсутствует или скрыт правами/пространством. По404 нельзя выяснить, есть ли чужая задача.
409: конфликт версии задачи. Перечитайте запись и разрешите конфликт.
422: данные не прошли проверку, например неверный статус или превышение лимита.
429: временный лимит попыток входа/регистрации.
503: сервис статистики временно недоступен; обычные операции с задачами могут продолжать работать.

Ответ содержит detail: строку либо массив ошибок валидации. Не полагайтесь на один формат строки для всех422.

Фильтры поиска и статистики

POST /issues/search и POST /statistics принимают search, queue_ids, status_ids, assignee_ids, mine, priority, category, overdue и label. Категории: open/progress/done. Приоритеты: low/normal/high/critical. Можно сочетать фильтры. Ответ поиска ограничен2000 задачами; при усечённой статистике возвращается truncated.

Повтор после сетевого сбоя

POST не поддерживает idempotency key. Если ответ потерялся, сначала проверьте результат, иначе повтор может создать вторую задачу, комментарий или запись времени. При повторяемой ошибке сократите запрос и проверьте права; не делайте бесконечный цикл повторов.