API:er

Ziqme-API:et

REST, webhooks och realtidshändelser — allt går genom en gateway.

REST-API:er

Versionerade REST-endpoints för ärenden, chattar, kunder, artiklar och arbetsflöden — bakom en gateway på api.ziqme.com.

Webhooks

Prenumerera på händelser som ticket.created eller chat.started och ta emot signerade leveranser till dina endpoints.

Realtidshändelser

SignalR-hubbar strömmar ärenden, chattar och panéluppdateringar live direkt in i dina egna appar.

Autentisering

Autentisera med OAuth2-klientuppgifter eller en användar-JWT. Varje förfrågan bär din arbetsytas kontext, så du ser alltid bara dina egna data.

Hastighetsgränser

Skäliga hastighetsgränser tillämpas per arbetsyta i gatewayen. Svaren innehåller standardheaders så att din integration kan backa på ett smidigt sätt.

Versionshantering

API:erna versioneras i URL:en (v1 i dag). Brytande ändringar levereras som en ny version — befintliga integrationer fortsätter att fungera.

Exempelförfrågan

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
}