Первый запрос за 5 минут

Пять минут от ключа до тикета в кабинете: выпустите ключ, проверьте его и заведите обращение клиента одним запросом.

1. Выпустите ключ

1. Нажмите «Выпустить ключ».

2. Назовите ключ по системе, которая будет им пользоваться, — например, «Сайт».

3. Оставьте отмеченными нужные права и нажмите «Выпустить».

4. Скопируйте ключ вида dsk_k_… — целиком он показывается один раз.

Сохраните ключ в переменную окружения — так он не попадёт в код:

export DESKUS_KEY='dsk_k_…'

2. Проверьте ключ

Запрос

curl https://app.deskus.ru/api/v1/me \
  -H "Authorization: Bearer $DESKUS_KEY"

Ответ 200

{
  "data": {
    "company": { "id": "6a0c4e8b-7d2f-4a1c-9e5b-8d3f2a7c0e19", "name": "Зерно" },
    "user": { "id": "d4e1b7a2-9c3f-4e6d-a5b8-0f2c7e9d1a35", "name": "Дарья Ветрова", "email": "daria@example.com" },
    "scopes": ["tickets:read", "tickets:write", "clients:read", "clients:write", "kb:read", "webhooks"],
    "credential": { "type": "api_key", "id": "8c4f2a6e-0b9d-4e1c-a7f3-2d5b8e1c9a46", "name": "Сайт" },
    "rate_limit": { "per_minute": 600 }
  }
}

Пришёл 401 — ключ скопирован не целиком или отозван. Все коды — в статье формат ошибок.

3. Создайте обращение

Запрос

curl https://app.deskus.ru/api/v1/tickets \
  -H "Authorization: Bearer $DESKUS_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: order-4821" \
  -d '{
    "subject": "Не пришёл заказ №4821",
    "message": "Заказала кило эфиопии три дня назад, посылки нет.",
    "client": { "name": "Мария Котова", "email": "maria@example.com" }
  }'

Ответ 201

{
  "data": {
    "id": "0b8f6c1e-5d2a-4c7b-9a31-6e2f7d4c9a10",
    "number": "T-1042",
    "subject": "Не пришёл заказ №4821",
    "status": "new",
    "priority": null,
    "channel": "API",
    "client_id": "5f1a9e7c-2b3d-4e8f-a0c1-7d6b5e4f3a21",
    "assignee_id": null,
    "team_id": null,
    "merged_into_id": null,
    "snoozed_until": null,
    "created_at": "2026-10-21T09:15:04.218Z",
    "updated_at": "2026-10-21T09:15:04.218Z",
    "last_activity_at": "2026-10-21T09:15:04.218Z",
    "closed_at": null,
    "url": "https://app.deskus.ru/tickets/0b8f6c1e-5d2a-4c7b-9a31-6e2f7d4c9a10"
  }
}

Что получится

В кабинете появится тикет T-1042 с каналом «API», клиент Мария Котова — новая карточка или найденная по почте. Команда получит уведомление, сработают правила автоматизаций, как на обращение из любого канала.