API-uri

API-ul Ziqme

REST, webhooks și evenimente în timp real — totul trece printr-un singur gateway.

API-uri REST

Endpoint-uri REST versionate pentru tichete, conversații, clienți, articole și fluxuri de lucru — în spatele unui singur gateway la api.ziqme.com.

Webhooks

Abonează-te la evenimente precum ticket.created sau chat.started și primește livrări semnate către endpoint-urile tale.

Evenimente în timp real

Hub-urile SignalR transmit în direct tichete, conversații și actualizări de dashboard direct în aplicațiile tale.

Autentificare

Autentifică-te cu date de acces client OAuth2 sau cu un JWT de utilizator. Fiecare cerere poartă contextul spațiului tău de lucru, așa că vezi doar propriile date.

Limite de trafic

Limitele de utilizare echitabilă se aplică per spațiu de lucru la nivelul gateway-ului. Răspunsurile includ headere standard, astfel încât integrarea ta să poată încetini elegant.

Versionare

API-urile sunt versionate în URL (v1 în prezent). Modificările incompatibile apar ca o versiune nouă — integrările existente continuă să funcționeze.

Exemplu de cerere

curl https://api.ziqme.com/api/v1/tickets \
  -H "Authorization: Bearer $ZIQME_ACCESS_TOKEN"

HTTP/1.1 200 OK
{
  "items": [
    {
      "id": "7d9f1c2e-4b6a-4f3d-9c1e-2a8b5d0e7f41",
      "subject": "Order #1042 arrived damaged",
      "status": "open",
      "priority": "high"
    }
  ],
  "totalCount": 128
}