APIs

Die Ziqme-API

REST, Webhooks und Echtzeit-Events — alles läuft über ein Gateway.

REST-APIs

Versionierte REST-Endpunkte für Tickets, Chats, Kunden, Artikel und Workflows — hinter einem Gateway unter api.ziqme.com.

Webhooks

Abonnieren Sie Events wie ticket.created oder chat.started und erhalten Sie signierte Zustellungen an Ihre Endpunkte.

Echtzeit-Events

SignalR-Hubs streamen Tickets, Chats und Dashboard-Updates live direkt in Ihre eigenen Apps.

Authentifizierung

Authentifizieren Sie sich mit OAuth2-Client-Zugangsdaten oder einem Benutzer-JWT. Jede Anfrage trägt Ihren Workspace-Kontext, Sie sehen also immer nur Ihre eigenen Daten.

Rate Limits

Fair-Use-Rate-Limits werden pro Workspace am Gateway angewendet. Antworten enthalten Standard-Header, damit Ihre Integration angemessen drosseln kann.

Versionierung

APIs werden in der URL versioniert (aktuell v1). Breaking Changes erscheinen als neue Version — bestehende Integrationen funktionieren weiter.

Beispielanfrage

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
}