लाइव डेमो

गाइड

API इंटीग्रेशन क्या है, ट्रैवल व्यवसायों के लिए समझाया गया

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

  • एक रिक्वेस्ट, एक रिस्पॉन्स
  • REST, XML, SOAP और वेबहुक
  • चार सिस्टम से गुज़रती एक बुकिंग
  • इंटीग्रेशन की टेस्टिंग कैसे होती है

परिभाषा

API इंटीग्रेशन क्या है, सरल भाषा में

API का मतलब है एप्लिकेशन प्रोग्रामिंग इंटरफ़ेस: नियमों का वह सेट जो कोई सिस्टम प्रकाशित करता है ताकि दूसरा सॉफ़्टवेयर उससे बात कर सके। API इंटीग्रेशन वह काम है जिसमें आपका प्लेटफ़ॉर्म ऐसे किसी इंटरफ़ेस से जोड़ा जाता है ताकि डेटा अपने आप चले और कार्रवाइयाँ अपने आप हों।

ट्रैवल में यह प्लेटफ़ॉर्म आमतौर पर ट्रैवल बुकिंग सॉफ़्टवेयर जैसा बुकिंग सिस्टम होता है, और इंटरफ़ेस किसी सप्लायर, पेमेंट गेटवे या बिज़नेस टूल का होता है। हमारा ट्रैवल API इंटीग्रेशन पेज बताता है कि PHPTRAVELS ये कनेक्शन कैसे डिलीवर करता है, और सभी इंटीग्रेशन में पहले से जुड़े सप्लायर सूचीबद्ध हैं।

  • डेटा का आदान-प्रदान

    दरें, उपलब्धता, ग्राहक विवरण और स्टेटस अपडेट संरचित प्रारूप में सिस्टमों के बीच चलते हैं।

  • कार्रवाइयाँ स्वचालित

    खोज, बुकिंग, भुगतान, रद्दीकरण और मिलान रिक्वेस्ट के रूप में होते हैं, न कि ऐसे चरणों के रूप में जिन्हें कोई हाथ से दोहराता है।

  • नतीजों की ट्रैकिंग

    हर कॉल के साथ एक रेफ़रेंस होता है, इसलिए असफल बुकिंग को उस रिक्वेस्ट तक ट्रेस किया जा सकता है जिसने उसे पैदा किया।

रिक्वेस्ट

POST /v1/hotels/availability HTTP/1.1Host: api.supplier.exampleAuthorization: Bearer sk_test_••••••••Content-Type: application/json{  "city": "DXB",  "check_in": "2026-11-12",  "check_out": "2026-11-14",  "guests": 2,  "currency": "USD"}

रिस्पॉन्स

HTTP/1.1 200 OKContent-Type: application/jsonX-Request-Id: req_7f3a91{  "hotel": "Palm Marina Hotel",  "room": "Deluxe, 2 adults",  "rate": { "amount": 438.00, "currency": "USD" },  "refundable": true,  "rate_key": "rk_19d2c7"}
एक काल्पनिक होटल सप्लायर को नमूना कॉल। फ़ील्ड के नाम, एंडपॉइंट और राशियाँ हर सप्लायर में अलग होती हैं।

एक API कॉल की संरचना

  1. 1

    एंडपॉइंट और मेथड

    ऑपरेशन का पता और उस पर इस्तेमाल होने वाली क्रिया: availability पर POST का मतलब है कमरे खोजो।

  2. 2

    ऑथेंटिकेशन

    कुंजी, टोकन या सिग्नेचर साबित करता है कि कौन कॉल कर रहा है। सप्लायर सैंडबॉक्स और प्रोडक्शन के लिए अलग-अलग क्रेडेंशियल जारी करते हैं।

  3. 3

    पेलोड

    संरचित इनपुट: शहर, तारीख़ें, मेहमान और मुद्रा। सप्लायर का दस्तावेज़ हर फ़ील्ड को परिभाषित करता है।

  4. 4

    स्टेटस कोड

    एक संख्या जो बताती है कि कॉल कैसी रही: 200 सफलता, 4xx रिक्वेस्ट में समस्या, 5xx सप्लायर की ओर समस्या।

  5. 5

    रिक्वेस्ट ID

    एक पहचानकर्ता जिसे दोनों पक्ष रखते हैं। जब सपोर्ट पूछता है कि किसी बुकिंग का क्या हुआ, तो यही खोजा जाता है।

  6. 6

    रिस्पॉन्स बॉडी

    सप्लायर के प्रारूप में जवाब, जिसे आपका प्लेटफ़ॉर्म अपने कमरों, दरों और नीतियों में मैप करता है।

एक बुकिंग, चार सिस्टम

होटल बुकिंग के दौरान API इंटीग्रेशन क्या करता है

दो रातों के एक ठहराव को खोज से वाउचर तक फ़ॉलो करें। हर तीर एक API कॉल है; यात्री सिर्फ़ पहला और आख़िरी देखता है।

  1. 01यात्रीबुकिंग प्लेटफ़ॉर्मदुबई में होटल खोजता है, दो रातें, दो मेहमान
  2. 02बुकिंग प्लेटफ़ॉर्मसप्लायर APIतारीख़ों, मेहमानों और मुद्रा के साथ उपलब्धता रिक्वेस्ट
  3. 03सप्लायर APIबुकिंग प्लेटफ़ॉर्मकमरे, दरें, नीतियाँ और एक रेट की
  4. 04बुकिंग प्लेटफ़ॉर्मयात्रीआपके मार्कअप और मुद्रा के साथ नतीजे दिखाए गए
  5. 05बुकिंग प्लेटफ़ॉर्मसप्लायर APIभुगतान से पहले चुनी गई रेट की पर कीमत की दोबारा जाँच
  6. 06बुकिंग प्लेटफ़ॉर्मपेमेंट गेटवेकुल राशि के लिए भुगतान ऑथराइज़ेशन
  7. 07पेमेंट गेटवेबुकिंग प्लेटफ़ॉर्मऑथराइज़्ड, हस्ताक्षरित वेबहुक प्राप्त
  8. 08बुकिंग प्लेटफ़ॉर्मसप्लायर APIमेहमान विवरण के साथ बुकिंग रिक्वेस्ट
  9. 09सप्लायर APIबुकिंग प्लेटफ़ॉर्मकन्फ़र्मेशन नंबर और रद्दीकरण शर्तें
  10. 10बुकिंग प्लेटफ़ॉर्मयात्रीवाउचर, इनवॉइस और बुकिंग रेफ़रेंस

बीच का प्लेटफ़ॉर्म ही वह जगह है जहाँ API इंटीग्रेशन रहता है: यह यात्री की स्क्रीन और हर सप्लायर के प्रारूप के बीच अनुवाद करता है, और हर रेफ़रेंस संग्रहित करता है।

यही क्रम GDS के साथ फ़्लाइट बुकिंग सॉफ़्टवेयर, एक्टिविटी सप्लायर के साथ टूर ऑपरेटर सॉफ्टवेयर और किसी भी गेटवे के साथ पेमेंट गेटवे इंटीग्रेशन के लिए काम करता है; सिर्फ़ फ़ील्ड के नाम बदलते हैं।

इंटीग्रेशन की शैलियाँ

REST, XML, SOAP, वेबहुक और GraphQL

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

  • REST और JSON

    JSON
    डेटा प्रारूप
    JSON दस्तावेज़
    ट्रांसपोर्ट
    HTTP मेथड: GET, POST, PUT, DELETE
    ट्रैवल में आम
    नए फ़्लाइट, होटल, एक्टिविटी और पेमेंट API
    ताक़त
    छोटे पेलोड और व्यापक डेवलपर टूलिंग
    ध्यान रखें
    ढीली परिभाषा; हर सप्लायर REST को अलग समझता है

  • XML और SOAP

    XML
    डेटा प्रारूप
    XML दस्तावेज़, अक्सर सख़्त स्कीमा के साथ
    ट्रांसपोर्ट
    SOAP एनवलप या सादे XML के साथ HTTP POST
    ट्रैवल में आम
    GDS, बेडबैंक और स्थापित होटल व टूर सिस्टम
    ताक़त
    औपचारिक अनुबंध, सिग्नेचर और सर्विस परिभाषाएँ
    ध्यान रखें
    लंबे संदेश और भारी पार्सिंग

  • वेबहुक

    EVENT
    डेटा प्रारूप
    JSON या XML, दूसरी ओर से पुश किया गया
    ट्रांसपोर्ट
    आपके पंजीकृत URL पर HTTP POST
    ट्रैवल में आम
    भुगतान नतीजे, बुकिंग स्टेटस बदलाव, टिकटिंग अपडेट
    ताक़त
    पोलिंग नहीं; कुछ होने पर आपके प्लेटफ़ॉर्म को बताया जाता है
    ध्यान रखें
    सिग्नेचर सत्यापित करना और दोहराव संभालना ज़रूरी

  • GraphQL

    QUERY
    डेटा प्रारूप
    JSON, आपकी भेजी क्वेरी के आकार में
    ट्रांसपोर्ट
    एक ही HTTP एंडपॉइंट
    ट्रैवल में आम
    कुछ नए डिस्ट्रीब्यूशन प्लेटफ़ॉर्म और आंतरिक API
    ताक़त
    ठीक वही फ़ील्ड माँगें जो आपको चाहिए
    ध्यान रखें
    ट्रैवल में सप्लायर समर्थन अभी कम है

API इंटीग्रेशन बनाम API डेवलपमेंट

API इंटीग्रेशन

आपके प्रोडक्ट को पहले से मौजूद इंटरफ़ेस से जोड़ता है। API सप्लायर का है; आप क्लाइंट, मैपिंग और उसके आसपास के नियम बनाते हैं।

API डेवलपमेंट

ऐसा इंटरफ़ेस बनाता है जिसे दूसरे सिस्टम आपके प्रोडक्ट से जुड़ने के लिए इस्तेमाल करते हैं, जैसे B2B API जिसे आपके एजेंटों के टूल कॉल कर सकें। अनुबंध और उसके संस्करण आपके हैं।

कई ट्रैवल प्रोजेक्ट में दोनों चाहिए: प्लेटफ़ॉर्म एक ओर सप्लायरों को इंटीग्रेट करता है और दूसरी ओर एजेंटों और पार्टनरों के लिए अपना API प्रकाशित करता है।

पहले और बाद में

सिस्टम इंटीग्रेट होने पर क्या बदलता है

बुकिंग के वही पाँच चरण, सप्लायर पोर्टलों पर हाथ से किए गए और API इंटीग्रेशन के ज़रिए किए गए।

खोज

बिना इंटीग्रेशनमैनुअल

एजेंट हर सप्लायर पोर्टल खोलकर कीमतें कोटेशन में कॉपी करता है।

API इंटीग्रेशन के साथस्वचालित

एक खोज हर जुड़े सप्लायर तक जाती है और एक ही सूची लौटाती है।

कीमत

बिना इंटीग्रेशनमैनुअल

मार्कअप स्प्रेडशीट में जोड़ा जाता है; कोटेशन भेजते-भेजते दर बदल चुकी हो सकती है।

API इंटीग्रेशन के साथस्वचालित

मार्कअप, कर और मुद्रा नियम रिस्पॉन्स के समय लागू होते हैं; भुगतान से पहले दर दोबारा जाँची जाती है।

बुकिंग

बिना इंटीग्रेशनमैनुअल

मेहमान विवरण सप्लायर पोर्टल में दोबारा टाइप होते हैं; टाइपो बुकिंग की गलतियाँ बन जाते हैं।

API इंटीग्रेशन के साथस्वचालित

विवरण एक बार भेजे जाते हैं, सत्यापित होते हैं और सप्लायर की पुष्टि के साथ संग्रहित होते हैं।

भुगतान

बिना इंटीग्रेशनमैनुअल

भुगतान अलग से लिया जाता है और बाद में बुकिंग से मिलाया जाता है।

API इंटीग्रेशन के साथस्वचालित

ऑथराइज़ेशन, कैप्चर और रिफ़ंड बुकिंग रेफ़रेंस से बंधे रहते हैं।

सेवा

बिना इंटीग्रेशनमैनुअल

रद्दीकरण और बदलाव का मतलब एक और लॉगिन और एक और ईमेल।

API इंटीग्रेशन के साथस्वचालित

बदलाव और रद्दीकरण उसी कनेक्शन से होते हैं और रिकॉर्ड अपडेट करते हैं।

ट्रैवल प्लेटफ़ॉर्म में API इंटीग्रेशन कहाँ दिखता है

शब्दावली

API दस्तावेज़ों में मिलने वाले शब्द

बारह शब्द जो लगभग हर सप्लायर के डेवलपर पोर्टल में आते हैं, ट्रैवल में जिस तरह इस्तेमाल होते हैं उसी तरह परिभाषित।

  • API

    एप्लिकेशन प्रोग्रामिंग इंटरफ़ेस: किसी सिस्टम से बात करने के प्रकाशित नियम।

  • ऑथेंटिकेशन

    यह साबित करना कि कौन कॉल कर रहा है, API कुंजी, बेयरर टोकन, सिग्नेचर या स्वीकृत IP पते से।

  • सर्टिफ़िकेशन

    प्रोडक्शन क्रेडेंशियल जारी करने से पहले सप्लायर द्वारा आपके इंटीग्रेशन की समीक्षा।

  • एंडपॉइंट

    एक ऑपरेशन के लिए एक पता, जैसे खोज, बुकिंग या रद्दीकरण।

  • आइडेम्पोटेंसी

    एक ही रिक्वेस्ट दो बार भेजने पर एक ही नतीजा आता है, जिससे दोहरी बुकिंग और दोहरे शुल्क रुकते हैं।

  • मैपिंग

    सप्लायर के फ़ील्ड, कोड और नामों को आपके प्लेटफ़ॉर्म के अपने डेटा मॉडल में बदलना।

  • पेलोड

    रिक्वेस्ट या रिस्पॉन्स के अंदर ले जाया गया डेटा, आमतौर पर JSON या XML।

  • रेट लिमिट

    प्रति सेकंड या प्रति दिन कॉल की वह संख्या जो सप्लायर मना करने से पहले अनुमति देता है।

  • रिक्वेस्ट और रिस्पॉन्स

    एक कॉल: आपका प्लेटफ़ॉर्म पूछता है, सप्लायर जवाब देता है, और दोनों पक्ष इसे लॉग करते हैं।

  • सैंडबॉक्स

    नकली इन्वेंटरी और टेस्ट कार्ड वाला टेस्ट वातावरण जहाँ वास्तव में कुछ भी बुक या चार्ज नहीं होता।

  • स्टेटस कोड

    नतीजे का सार बताने वाली HTTP संख्या: 200 सफलता, 401 अनधिकृत, 429 रेट लिमिट, 500 सप्लायर त्रुटि।

  • वेबहुक

    उल्टी दिशा की कॉल: कोई घटना होने पर सप्लायर या गेटवे आपके प्लेटफ़ॉर्म को सूचित करता है।

टेस्टिंग और स्कोपिंग

लाइव होने से पहले ट्रैवल API इंटीग्रेशन की टेस्टिंग कैसे होती है

इंटीग्रेशन तभी पूरा होता है जब असफल रास्ते भी सही व्यवहार करें। सप्लायर सैंडबॉक्स पर एक टेस्ट रन सर्टिफ़िकेशन और प्रोडक्शन क्रेडेंशियल पर जाने से पहले नीचे दिए मामलों को कवर करता है।

run integration tests

सप्लायर सैंडबॉक्स, नौ मामले

  • OK: वैध और समाप्त क्रेडेंशियल के साथ ऑथेंटिकेशन
  • OK: अमान्य रिक्वेस्ट पठनीय त्रुटि के साथ अस्वीकृत
  • OK: सप्लायर टाइमआउट बिना अटकी बुकिंग के संभाला गया
  • OK: रेट लिमिट का पालन और प्रतीक्षा के बाद पुनः प्रयास
  • OK: दोबारा जाँच में कीमत बदलाव पकड़ा गया और भुगतान से पहले दिखाया गया
  • OK: दोहरा सबमिशन पहली बुकिंग लौटाता है, दूसरी नहीं
  • OK: रद्दीकरण लागू और शुल्क की गणना
  • OK: मूल भुगतान पर रिफ़ंड जारी
  • OK: बुकिंग, भुगतान और सप्लायर रेफ़रेंस का मिलान

सभी मामले पास, सर्टिफ़िकेशन के लिए तैयार

स्कोपिंग के लिए आपसे क्या चाहिए

  1. 1सप्लायर अनुबंध, दस्तावेज़ और सैंडबॉक्स क्रेडेंशियल
  2. 2बाज़ार, मुद्राएँ, उत्पाद और उपयोगकर्ता भूमिकाएँ
  3. 3खोज, बुकिंग, बदलाव, रद्दीकरण और रिफ़ंड का दायरा
  4. 4सर्टिफ़िकेशन की ज़रूरतें और प्रोडक्शन एक्सेस की प्रक्रिया

सप्लायर जोड़ने के लिए तैयार

PHPTRAVELS सप्लायरों, गेटवे और बिज़नेस टूल को एक सेल्फ़-होस्टेड प्लेटफ़ॉर्म में इंटीग्रेट करता है जो सोर्स कोड के साथ दिया जाता है। तीन एकमुश्त प्लान के लिए कीमतें देखें, या किसी ख़ास API के बारे में हमसे पूछें।

डेमो का अनुरोध करेंहमसे बात करें

आगे पढ़ें

सवाल

API इंटीग्रेशन के सवाल, जवाब सहित

पहले इंटीग्रेशन प्रोजेक्ट से पहले लोग जो सवाल पूछते हैं, उनके छोटे जवाब।

सेल्स से बात करें

API इंटीग्रेशन एक कनेक्शन है जिससे दो सॉफ़्टवेयर सिस्टम अपने आप डेटा का आदान-प्रदान करते हैं और कार्रवाइयाँ शुरू करते हैं। एक सिस्टम संरचित रिक्वेस्ट भेजता है, दूसरा संरचित रिस्पॉन्स लौटाता है, और दोनों सुरक्षा और डेटा के तय नियमों का पालन करते हैं।

ट्रैवल में यह बुकिंग प्लेटफ़ॉर्म को फ़्लाइट, होटल, टूर या कार सप्लायरों, पेमेंट गेटवे और बिज़नेस टूल से जोड़ता है। यह बिना दोबारा टाइप किए खोज, कीमत सत्यापन, बुकिंग, रद्दीकरण, रिफ़ंड और मिलान का समर्थन करता है।

REST एक आर्किटेक्चर शैली है जो आमतौर पर HTTP पर JSON का आदान-प्रदान करती है। XML एक डेटा प्रारूप है जो GDS और बेडबैंक सप्लायरों में अब भी आम है, अक्सर SOAP में लिपटा हुआ। सप्लायर का अनुबंध और दस्तावेज़ तय करते हैं कि आप कौन सा इस्तेमाल करेंगे।

यह सप्लायर एक्सेस, दायरे में शामिल एंडपॉइंट, सर्टिफ़िकेशन, मैपिंग नियमों और बुकिंग के विशेष मामलों पर निर्भर करता है। भरोसेमंद अनुमान दस्तावेज़, क्रेडेंशियल और आपके ज़रूरी वर्कफ़्लो की समीक्षा के बाद ही मिलता है।

ऑथेंटिकेशन, वैध और अमान्य रिक्वेस्ट, टाइमआउट, रेट लिमिट, कीमत बदलाव, दोहरे सबमिशन, रद्दीकरण, रिफ़ंड और मिलान की जाँच करें। प्रोडक्शन में हर रिक्वेस्ट किसी बुकिंग रेफ़रेंस तक ट्रेस होनी चाहिए।

नहीं। इंटीग्रेशन आपके प्रोडक्ट को मौजूदा API से जोड़ता है; डेवलपमेंट ऐसा इंटरफ़ेस बनाता है जिससे दूसरे जुड़ते हैं। ट्रैवल प्लेटफ़ॉर्म को अक्सर दोनों चाहिए: एक ओर इंटीग्रेट किए गए सप्लायर और दूसरी ओर पार्टनरों के लिए प्रकाशित B2B API।

और जानें

प्लेटफ़ॉर्म के बारे में और