واجهات API

واجهة Ziqme API

REST وwebhooks وأحداث فورية — كل شيء يمر عبر بوابة واحدة.

واجهات REST API

نقاط نهاية REST بإصدارات محددة للتذاكر والمحادثات والعملاء والمقالات وسير العمل — خلف بوابة واحدة على api.ziqme.com.

Webhooks

اشترك في أحداث مثل ticket.created أو chat.started واستقبل عمليات تسليم موقعة إلى نقاط النهاية الخاصة بك.

أحداث فورية

تبث مراكز SignalR التذاكر والمحادثات وتحديثات لوحة القيادة مباشرة إلى تطبيقاتك الخاصة.

المصادقة

صادق باستخدام بيانات اعتماد عميل OAuth2 أو JWT للمستخدم. يحمل كل طلب سياق مساحة عملك، لذا لن ترى سوى بياناتك الخاصة.

حدود المعدل

تُطبق حدود معدل الاستخدام العادل لكل مساحة عمل عند البوابة. تتضمن الاستجابات ترويسات قياسية ليتمكن تكاملك من التباطؤ بسلاسة.

إدارة الإصدارات

تُرقَّم واجهات API في عنوان URL (الإصدار v1 حاليًا). تصدر التغييرات الجذرية كإصدار جديد — وتستمر التكاملات الحالية في العمل.

مثال على طلب

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
}