واجهة REST
موارد صريحة، وأفعال HTTP معيارية، وردود JSON، ورموز أخطاء ثابتة. والمعرّفات التي تعود عند الإنشاء هي نفسها المستعملة في كل مكان.
المطوّرون
اربط المزايا بأنظمتك
واجهة REST بصيغة JSON، موثّقة بمفتاح، تعرض ما تفعله البوابة: إنشاء مستفيد، وإصدار بطاقة، وشحن محفظة، وإيداع دفعة صرف، وقراءة رصيد.
ما تمنحك الواجهة البرمجية
webhooks موقّعة
كل حدث في دورة الحياة — بطاقة صدرت، محفظة شُحنت، معاملة قُبلت — يمكن دفعه إلى نقطتك، مع توقيع يُتحقَّق منه.
بيئة اختبار
بيئة معزولة، بمفاتيحها الخاصة وبيانات قابلة للإتلاف، لإجراء الدمج كاملًا قبل الانتقال إلى الإنتاج.
تُدار مفاتيح الواجهة من البوابة
كل شركة تولّد مفاتيحها وتسمّيها وتلغيها. ويتوقّف قبول المفتاح الملغى فورًا. ولا يُعرض المفتاح كاملًا إلا مرة واحدة عند الإنشاء — وبعدها لا تبقى ظاهرة سوى بصمته.
- مفتاح لكل عملية دمج، حتى يمكن إلغاء واحد دون تعطيل الباقي
- لا مفتاح في شيفرة العميل ولا في مستودع
- تدوير دوري: أنشئ المفتاح الجديد قبل إلغاء القديم
# En-tête de chaque appelAuthorization: Bearer tk_live_9f2c… # 401 si la clé est révoquée{ "error": "invalid_api_key"}استقبال الأحداث
صرّح برابط، واختر الأحداث التي تهمّك، وتحقّق من التوقيع عند الاستقبال. وتُعاد محاولة التسليمات المتعثّرة، ويبقى سجلّها قابلًا للاطلاع من البوابة.
{ "event": "gift_card.redeemed", "reference": "gc_4KQ2mn", "amount": 180.00, "balance": 320.00, "occurredAt": "2026-09-15T12:04:11Z"} // X-Tiki-Signature: à vérifier avant de traiterمسار الدمج
احصل على وصول اختباري
تتلقّى بيئة معزولة ومفتاحًا مخصّصًا، دون التزام ودون بيانات حقيقية.
أنجز الحالات
تنفّذ الإصدار والشحن واستقبال الـwebhooks، وتعيد تشغيل حالات الخطأ.
انتقل إلى الإنتاج
النداءات نفسها، ومفتاح إنتاج، ومستفيدوك الحقيقيون. وعقد الواجهة لا يتغيّر.
يُسلَّم دليل الدمج المفصّل ومرجع النقاط وأمثلة الحمولات عند فتح بيئة الاختبار. اكتب إلينا للحصول عليها.
اطلب وصولًا اختباريًا
أخبرنا بما تريد أتمتته ومن أي نظام. نفتح بيئة اختبار ونرافقك في النداءات الأولى.