पार्टनर पोर्टल

यहाँ कुछ होते ही किसी बाहरी सिस्टम को उसी पल कैसे सूचित करें। आप किसी घटना के लिए एक पता सब्सक्राइब करते हैं, और प्लेटफ़ॉर्म उसे कॉल करने लगता है — हर डिलीवरी के रिकॉर्ड के साथ।

tenant एक ENDPOINT (आपका एक URL) दर्ज करता है ताकि Tenka में हर बार कोई व्यावसायिक घटना होने पर उसे HTTP से सूचित किया जाए — अनुबंध पर हस्ताक्षर, दस्तावेज़ का भुगतान, FCA खुला। हर सूचना एक POST है जिस पर बॉडी का HMAC-SHA256 हस्ताक्षर होता है, ऐसे सीक्रेट से जिसे केवल आप और Tenka जानते हैं (header X-Tenka-Signature): आपका सिस्टम हस्ताक्षर जाँचता है और जान लेता है कि कॉल Tenka से आई और उसमें छेड़छाड़ नहीं हुई। यहाँ आप सब्सक्रिप्शन बनाते हैं (url + घटना + सीक्रेट), उसे सक्रिय/निष्क्रिय करते हैं, डिलीवरी का रिकॉर्ड देखते हैं (लंबित → डिलीवर | विफल, प्रयासों की संख्या और backoff के साथ), और एक टेस्ट घटना चला सकते हैं या विफल डिलीवरी को फिर से कतार में डाल सकते हैं। "*" घटना सभी के लिए सब्सक्राइब करती है। यह आंतरिक बिलिंग webhooks (Asaas) से अलग है।

हर डिलीवरी सब्सक्रिप्शन के सीक्रेट से हस्ताक्षरित होती है। प्राप्तकर्ता को सामग्री पर भरोसा करने से पहले यह हस्ताक्षर ज़रूर जाँचना चाहिए — इसके बिना जो भी आपका URL जान ले, वह उस पर नकली घटना भेज सकता है।

टेस्ट बटन घटना होने का इंतज़ार किए बिना अभी आपके endpoint पर एक असली घटना भेजता है। 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.

बंद पड़ा endpoint घटना नहीं खोता: प्लेटफ़ॉर्म प्रयासों के बीच अंतर बढ़ाते हुए फिर से कोशिश करता है। रिकॉर्ड स्थिति और प्रयासों की संख्या दिखाता है — वहीं पता चलता है कि इंटीग्रेशन इसलिए "रुक गया" क्योंकि दूसरी तरफ़ का प्रमाणपत्र समाप्त हो गया।

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 मेरे किन सिस्टम को सूचित करता है — और क्या डिलीवरी पहुँच रही हैं? हर व्यावसायिक घटना के लिए एक endpoint (आपका एक URL) दर्ज करें और Tenka बॉडी के HMAC-SHA256 से हस्ताक्षरित एक POST भेजता है (header X-Tenka-Signature), जिसे आपका सिस्टम जाँचकर जान लेता है कि कॉल यहीं से आई और उसमें छेड़छाड़ नहीं हुई। डिलीवरी रिकॉर्ड लंबित, डिलीवर या विफल दिखाता है, प्रयासों की संख्या और backoff के साथ; टेस्ट घटना चलाई जा सकती है और विफल डिलीवरी को फिर से कतार में डाला जा सकता है। * घटना endpoint को सभी घटनाओं के लिए सब्सक्राइब करती है।