TokenNo

واجهة التكامل (API)

اربط TokenNo بالأنظمة اللي تشتغل عليها.

المستشفيات والعيادات والمطاعم تقدر تربط نظام المستشفى أو برنامج العيادة أو نظام نقاط البيع مع TokenNo — في الاتجاهين. نظامك يظل المرجع في شغله، وTokenNo يدير الطابور المباشر.

اطلب الوصول إلى الـ API

يشتغل في الاتجاهين

  • اسحب البيانات من TokenNo

    اقرأ فروعك ونقاط الخدمة والجلسات والأرقام والطابور المباشر من برنامجك.

  • أرسل الإجراءات إلى TokenNo

    أنشئ أرقام الحضور المباشر والهاتف، نادِ أو أنهِ الخدمة أو أخّر أو ألغِ الأرقام، وأدِر الفترات والإجازات — نفس اللي تسويه في التطبيق.

  • استقبل الأحداث من TokenNo

    استقبل إشعارات Webhook موقّعة لحظة ما يصير شيء: رقم انضاف أو انادى أو تغيّر ترقيمه أو انخدم أو انلغى، جلسة انلغت، دفعة نجحت، وغيرها.

نظرة سريعة

بعض الـ Endpoints والأحداث. التوثيق الكامل يوصلك لما تحصل على الوصول للـ API.

وش يربطون الفرق عادةً

  • أنظمة إدارة المستشفيات (HMS)
  • برامج العيادات والممارسات الطبية
  • أنظمة نقاط البيع وإدارة الطاولات في المطاعم
  • موقعك الإلكتروني أو أدواتك الداخلية
واجهة تكامل TokenNo

المصادقة

  • Authorization: Bearer tkn_live_…
  • # وضع الاختبار: tkn_test_…

Endpoints

  • GET /v1/integration/sessions/:sid/queue
  • GET /v1/integration/tokens?date&servicePointId&status
  • POST /v1/integration/sessions/:sid/tokens
  • POST /v1/integration/tokens/:tid/call
  • POST /v1/integration/tokens/:tid/push-back

أحداث Webhook

  • token.created
  • token.called
  • token.renumbered
  • token.cancelled
  • token.served
  • session.cancelled
  • holiday.created
  • payment.succeeded
  • X-TokenNo-Signature: v1=<HMAC-SHA256>

الأمان من أول يوم

مفاتيح الـ API تصدر من TokenNo، وينشئها مالك النشاط أو المدير من TokenNo Business. وكل طلب يُسجَّل في سجل التدقيق.

  • المفتاح يظهر مرة وحدة

    المفتاح السري الجديد يظهر لك مرة وحدة بس. TokenNo يحفظ بصمة مشفّرة منه، مو المفتاح نفسه.

  • صلاحيات وفروع محددة

    أعطِ كل مفتاح اللي يحتاجه بس — قراءة الطابور، التعديل عليه، إدارة الجداول — وحدده بفروع معيّنة.

  • قائمة عناوين IP مسموحة

    تقدر تقبل الطلبات من عناوين IP خوادمك فقط.

  • تدوير وانتهاء وإلغاء

    حدد تاريخ انتهاء، وبدّل المفاتيح مع فترة تداخل عشان ما يتعطل شيء، وألغِ أي مفتاح فورًا.

  • Webhooks موقّعة

    كل إشعار Webhook موقّع بـ HMAC-SHA256 مع طابع زمني، عشان تتأكد إنه من TokenNo وتمنع إعادة الإرسال. والإرسال الفاشل يُعاد تلقائيًا، وتقدر تعيده يدويًا.

  • وضع الاختبار

    ابنِ على مفاتيح اختبار وبيانات تجريبية أول، وبعدها انتقل للمفاتيح الحقيقية لما تكون جاهز.

  • إعادة محاولة آمنة

    طلبات الكتابة تقبل Idempotency-Key، فإعادة المحاولة ما تنشئ رقمًا مكررًا أبدًا. وفيه حد للطلبات لكل مفتاح.

  • أقل قدر من بيانات المرضى

    الـ API يتبع نفس قواعد البيانات في التطبيقات: في المرحلة الأولى، اسم ورقم جوال فقط لكل عميل.

تبي تربط نظامك؟

قل لنا وش النظام اللي تستخدمه، ونجهّز لك مفاتيح اختبار والتوثيق الكامل للـ API.

اطلب الوصول إلى الـ API