Ziqme API
REST, webhook'lar ve gerçek zamanlı olaylar — her şey tek bir ağ geçidinden geçer.
REST API'leri
Talepler, sohbetler, müşteriler, makaleler ve iş akışları için sürümlü REST uç noktaları — api.ziqme.com adresindeki tek ağ geçidinin arkasında.
Webhook'lar
ticket.created veya chat.started gibi olaylara abone olun ve uç noktalarınıza imzalı teslimatlar alın.
Gerçek zamanlı olaylar
SignalR hub'ları canlı talepleri, sohbetleri ve pano güncellemelerini doğrudan kendi uygulamalarınıza aktarır.
Kimlik doğrulama
OAuth2 istemci kimlik bilgileri veya kullanıcı JWT'si ile kimlik doğrulaması yapın. Her istek çalışma alanı bağlamınızı taşır, bu nedenle yalnızca kendi verilerinizi görürsünüz.
Hız sınırları
Adil kullanım hız sınırları, ağ geçidinde çalışma alanı başına uygulanır. Yanıtlar, entegrasyonunuzun hızını nazikçe düşürebilmesi için standart başlıklar içerir.
Sürümleme
API'ler URL içinde sürümlenir (bugün v1). Uyumsuz değişiklikler yeni bir sürüm olarak yayınlanır — mevcut entegrasyonlar çalışmaya devam eder.
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
}