A Ziqme API
REST, webhookok és valós idejű események — minden egyetlen átjárón keresztül halad.
REST API-k
Verziózott REST-végpontok jegyekhez, csevegésekhez, ügyfelekhez, cikkekhez és munkafolyamatokhoz — egyetlen átjáró mögött az api.ziqme.com címen.
Webhookok
Iratkozzon fel olyan eseményekre, mint a ticket.created vagy a chat.started, és kapjon aláírt kézbesítéseket a végpontjaira.
Valós idejű események
A SignalR hubok élőben közvetítik a jegyeket, csevegéseket és irányítópult-frissítéseket közvetlenül az Ön alkalmazásaiba.
Hitelesítés
Hitelesítsen OAuth2 klienshitelesítő adatokkal vagy felhasználói JWT-vel. Minden kérés hordozza a munkaterülete kontextusát, így mindig csak a saját adatait látja.
Sebességkorlátok
A méltányos használati korlátok munkaterületenként érvényesülnek az átjárónál. A válaszok szabványos fejléceket tartalmaznak, hogy integrációja megfelelően lassíthasson.
Verziókezelés
Az API-k az URL-ben verziózottak (jelenleg v1). A nem kompatibilis változások új verzióként jelennek meg — a meglévő integrációk tovább működnek.
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
}