Адрес, версии и формат
Общие правила для всех методов: куда слать запросы, в каком виде и что приходит в ответ.
Адрес
https://app.deskus.ru/api/v1Только HTTPS. Тикет можно указывать в адресе и по id, и по номеру из кабинета: /tickets/T-1042 — номер без учёта регистра.
Версии
Версия — в адресе:
/api/v1. Внутри версии ответы только дополняются: новые поля и новые значения перечислений не ломают совместимость — не падайте на незнакомом поле.Поле не убираем и смысл его не меняем без новой версии. О новой версии сообщим заранее, старая продолжит работать.
Все изменения — в журнале изменений.
Запрос
Заголовок | Зачем |
|---|---|
| Доступ. Ключ можно передать и заголовком |
| У POST и PATCH — тело JSON-объектом, до 256 КБ. |
| У POST — защита от дублей при повторе (подробнее). |
Куки не работают
API не принимает куки сессии кабинета — только ключ или токен в заголовке. Запросы из браузера на чужом сайте не поддерживаются: ключ там был бы виден всем.
Ответ
JSON в кодировке UTF-8. Один объект — в поле
data, список — вdataиnext_cursor(постраничный вывод).Время — ISO 8601 в UTC:
2026-10-21T09:15:04.218Z.Статусы и приоритеты — ключами (
open,high), а не подписями из интерфейса.Пустое значение —
null, поле при этом есть.Ошибка —
{ "error": { "code", "message", "request_id" } }(все коды).
Заголовок ответа | Что в нём |
|---|---|
| Номер запроса. Пишите его в поддержку — найдём запрос в журнале. |
| Лимит в минуту и сколько осталось (лимиты). |
| Ответ повторён по |