API Дескуса™ — тикеты, клиенты и вебхуки для интеграций

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

curl https://app.deskus.ru/api/v1/tickets/T-1042/messages \
  -H "Authorization: Bearer dsk_k_…" \
  -H "Content-Type: application/json" \
  -d '{ "type": "reply", "text": "Анна, посылка уже в пути — трек придёт письмом." }'

curl "https://app.deskus.ru/api/v1/tickets?status=new,open&limit=50" \
  -H "Authorization: Bearer dsk_k_…"

{ "data": [ { "id": "…", "number": "T-1042", "status": "open", … } ],
  "next_cursor": "WyIyMDI2LTEwLTIw…" }

HTTP/1.1 422
X-Request-Id: req_8d1f…

{ "error": {
    "code": "validation_error",
    "message": "Поле message обязательно.",
    "details": { "field": "message" },
    "request_id": "req_8d1f…" } }

POST https://example.com/deskus/webhook
X-Deskus-Event: ticket.updated
X-Deskus-Delivery: 3f0c…
X-Deskus-Signature: sha256=9b1e…

{
  "id": "evt_5c2a…",
  "type": "ticket.updated",
  "created_at": "2026-10-20T09:15:00.000Z",
  "company_id": "…",
  "data": {
    "ticket": { "number": "T-1042", "status": "closed", … },
    "changes": { "status": { "from": "open", "to": "closed" } }
  }
}

import crypto from "node:crypto";

// rawBody — тело запроса байтами, до JSON.parse
function isFromDeskus(rawBody, signatureHeader, secret) {
  const expected = "sha256=" + crypto.createHmac("sha256", secret).update(rawBody).digest("hex");
  const a = Buffer.from(expected);
  const b = Buffer.from(String(signatureHeader || ""));
  return a.length === b.length && crypto.timingSafeEqual(a, b);
}