TokenNo

Integration API

TokenNo को अपने चल रहे सिस्टम से जोड़िए।

हॉस्पिटल, क्लिनिक और रेस्टोरेंट अपना HMS, क्लिनिक सॉफ़्टवेयर या POS TokenNo से जोड़ सकते हैं — दोनों तरफ़ से। आपका सिस्टम अपना काम करता रहे, और लाइव लाइन TokenNo संभाले।

API एक्सेस माँगें

दोनों तरफ़ काम करता है

  • TokenNo से डेटा लीजिए

    अपनी लोकेशन, सर्विस पॉइंट, सेशन, टोकन और लाइव लाइन अपने सॉफ़्टवेयर में पढ़िए।

  • एक्शन TokenNo में भेजिए

    वॉक-इन और फ़ोन टोकन बनाइए, टोकन कॉल, सर्व्ड, पुश बैक या कैंसिल कीजिए, और स्लॉट व छुट्टियाँ मैनेज कीजिए — वही सब जो ऐप में होता है।

  • इवेंट्स अपने सिस्टम में पाइए

    कुछ भी होते ही साइन किए हुए वेबहुक पाइए: टोकन बना, कॉल हुआ, नंबर बदला, सर्व हुआ या कैंसिल हुआ, सेशन कैंसिल हुआ, पेमेंट सफल हुआ, वगैरह।

एक झलक

कुछ एंडपॉइंट और इवेंट्स। API एक्सेस मिलने पर पूरा डॉक्यूमेंटेशन शेयर किया जाता है।

टीमें आम तौर पर क्या जोड़ती हैं

  • हॉस्पिटल मैनेजमेंट सिस्टम (HMS)
  • क्लिनिक और प्रैक्टिस सॉफ़्टवेयर
  • रेस्टोरेंट POS और टेबल मैनेजमेंट
  • आपकी अपनी वेबसाइट या अंदरूनी टूल्स
TokenNo Integration API

ऑथेंटिकेशन

  • Authorization: Bearer tkn_live_…
  • # टेस्ट मोड: tkn_test_…

एंडपॉइंट

  • 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

वेबहुक इवेंट्स

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

पहले दिन से सिक्योरिटी

API keys TokenNo जारी करता है, और इन्हें बिज़नेस के मालिक या मैनेजर TokenNo Business में बनाते हैं। हर कॉल का ऑडिट लॉग रहता है।

  • Key सिर्फ़ एक बार दिखती है

    नई secret key सिर्फ़ एक बार दिखती है। TokenNo उसका सिर्फ़ हैश सेव करता है, key नहीं।

  • स्कोप और लोकेशन

    हर key को उतना ही एक्सेस दीजिए जितना ज़रूरी है — लाइन पढ़ना, लाइन में बदलाव, शेड्यूल मैनेज करना — और उसे चुनी हुई लोकेशन तक सीमित कीजिए।

  • IP अलाउलिस्ट

    चाहें तो सिर्फ़ अपने सर्वर के IP एड्रेस से आने वाली कॉल ही मंज़ूर कीजिए।

  • रोटेट, एक्सपायरी, रिवोक

    एक्सपायरी डेट रखिए, ओवरलैप विंडो के साथ key बदलिए ताकि कुछ न टूटे, और किसी भी key को तुरंत रिवोक कीजिए।

  • साइन किए हुए वेबहुक

    हर वेबहुक HMAC-SHA256 और टाइमस्टैम्प के साथ साइन होता है, ताकि आप चेक कर सकें कि यह TokenNo से ही आया है और रीप्ले रोक सकें। फ़ेल हुई डिलीवरी दोबारा भेजी जाती है, और आप उसे रीप्ले भी कर सकते हैं।

  • टेस्ट मोड

    पहले test keys और सैंडबॉक्स डेटा पर बनाइए, फिर तैयार होने पर live keys पर स्विच कीजिए।

  • सेफ़ रीट्राई

    राइट कॉल में Idempotency-Key चलती है, तो दोबारा कोशिश करने पर कभी डुप्लिकेट टोकन नहीं बनता। हर key पर रेट लिमिट भी है।

  • मरीज़ों का कम से कम डेटा

    API भी ऐप वाले डेटा नियम मानता है: पहले फ़ेज़ में हर कस्टमर का सिर्फ़ नाम और मोबाइल नंबर।

अपना सिस्टम जोड़ना है?

बताइए आप अभी कौन-सा सिस्टम इस्तेमाल करते हैं, हम आपको test keys और पूरे API डॉक्स दे देंगे।

API एक्सेस माँगें