بوابة الشريك

كيف تُخطر نظامًا خارجيًا في اللحظة التي يحدث فيها شيء هنا. تشترك بعنوان في حدث، فتبدأ المنصة في استدعائه — مع سجل لكل تسليم.

يسجّل الـ tenant نقطة نهاية (عنوان URL خاصًا بك) ليتلقى إخطارًا عبر HTTP في كل مرة يقع فيها حدث عمل في Tenka — عقد موقّع، سند مدفوع، FCA مفتوح. كل إخطار هو طلب POST موقّع بـ HMAC-SHA256 للمحتوى باستخدام سرّ لا يعرفه إلا أنت وTenka (الترويسة X-Tenka-Signature): يتحقق نظامك من التوقيع فيعرف أن الاستدعاء جاء من Tenka ولم يُعبث به. هنا تنشئ الاشتراك (url + حدث + سرّ)، وتفعّله أو تعطّله، وتتابع سجل التسليمات (معلّق ← مُسلَّم | فشل، مع عدد المحاولات والـ backoff)، ويمكنك إطلاق حدث اختبار أو إعادة إدراج تسليم فاشل في الطابور. الحدث "*" يشترك في الكل. مختلف عن webhooks الفوترة الداخلية (Asaas).

يُوقَّع كل تسليم بسرّ الاشتراك. يجب على المستلم التحقق من هذا التوقيع قبل الوثوق بالمحتوى — ومن دون ذلك يستطيع أي شخص يكتشف عنوان URL الخاص بك أن يرسل إليه حدثًا مزيفًا.

يرسل زر الاختبار حدثًا حقيقيًا إلى نقطة النهاية الخاصة بك الآن، دون انتظار وقوع الواقعة. إنها أسرع طريقة لاكتشاف خطأ في عنوان URL أو الجدار الناري أو التوقيع — قبل أن يضيع أول حدث حقيقي في الطابور.

A API pública /api/v1 é congelada: nada some nem muda de tipo; mudança que quebra vai para /v2. O SDK sai do próprio contrato: /api/v1/sdk/tenka.js e /api/v1/sdk/tenka.py. O histórico de versões está no documento API-CHANGELOG da Biblioteca.

نقطة النهاية المتوقفة لا تفقد الحدث: تعيد المنصة المحاولة مع المباعدة بين المحاولات. يعرض السجل الحالة وعدد المحاولات — ومن هناك تكتشف أن التكامل "توقف" لأن الشهادة في الطرف الآخر انتهت صلاحيتها.

O log de eventos mostra tudo que a conta enviou, em todas as inscrições, com filtro por evento e situação. Reenviar cria uma entrega nova com o mesmo conteúdo e o cabeçalho X-Tenka-Replay-Of com o id da original, para o sistema que recebe não duplicar. Toda entrega leva X-Tenka-Event-Version com a versão do contrato.

أي من أنظمتي يُخطرها Tenka عند حدوث شيء — وهل التسليمات تصل؟ سجّل نقطة نهاية (عنوان URL خاصًا بك) لكل حدث عمل، فيرسل Tenka طلب POST موقّعًا بـ HMAC-SHA256 للمحتوى (الترويسة X-Tenka-Signature)، يتحقق منه نظامك ليعرف أن الاستدعاء جاء من هنا ولم يُعبث به. يعرض سجل التسليمات معلّق أو مُسلَّم أو فشل، مع عدد المحاولات والـ backoff؛ ويمكن إطلاق حدث اختبار وإعادة إدراج تسليم فاشل في الطابور. الحدث * يشترك بنقطة النهاية في جميع الأحداث.