CreateBooking Ready

CreateBooking तैयार माइलस्टोन टास्क को पूरा करने के लिए, आपको CreateBooking तरीके को सही तरीके से बनाना और डिलीवर करना होगा. इस तरीके का इस्तेमाल तब किया जाता है, जब कोई उपयोगकर्ता बुकिंग करने की कोशिश करता है. अगर बुकिंग हो जाती है, तो जवाब में एक यूनीक booking_id शामिल होता है. इसका इस्तेमाल आने वाले समय में बुकिंग से जुड़े अनुरोध करने या बुकिंग को अपडेट करने के लिए किया जा सकता है.

CreateBooking टास्क के लिए ज़रूरी शर्तें

  • गड़बड़ी की दर 10% से कम होने पर, CreateBooking के 10 अनुरोध पूरे होने चाहिए.

CreateBooking की बुनियादी बातें

जब कोई उपयोगकर्ता बुकिंग शुरू करता है, तो CreateBooking अनुरोध, पार्टनर के बुकिंग सर्वर को भेजा जाता है. अनुरोध के जवाब में, बुकिंग के पूरा होने या बुकिंग के फ़ेल होने की जानकारी मिलती है. अगर बुकिंग नहीं हो पाती है, तो जवाब में बुकिंग न होने की वजह से कारोबार के लॉजिक में हुई गड़बड़ी की जानकारी शामिल होनी चाहिए. उदाहरण के लिए, स्लॉट उपलब्ध नहीं है या उसे पहले ही किसी दूसरे व्यक्ति ने बुक कर लिया है.

जब कोई व्यक्ति बुकिंग करता है, तो Google आपको उसका नाम, उपनाम, फ़ोन नंबर, और ईमेल भेजता है. ज़्यादा जानकारी के लिए, खाता मैच करने और बनाने से जुड़ी नीति देखें.

आइडमपोटेंसी

नेटवर्क पर कम्यूनिकेशन हमेशा भरोसेमंद नहीं होता. अगर कोई जवाब नहीं मिलता है, तो Google एचटीटीपी अनुरोधों को फिर से भेज सकता है. इस वजह से, स्टेट में बदलाव करने वाले सभी तरीकों को आइडेमपोटेंट होना चाहिए:

  • CreateBooking
  • UpdateBooking

UpdateBooking को छोड़कर, हर अनुरोध मैसेज के लिए, अनुरोध की यूनीक पहचान करने के लिए, आइडमपोटेंसी टोकन शामिल किए जाते हैं. इससे आपको यह पता चलता है कि एक अनुरोध और दो अलग-अलग अनुरोध बनाने के मकसद से, फिर से किए गए REST कॉल के बीच क्या अंतर है. UpdateBooking के अनुरोधों में, बुकिंग एंट्री आईडी शामिल होते हैं. इनसे उनकी पहचान की जा सकती है. इसलिए, उनके अनुरोधों में कोई भी आइडमपोटेंसी टोकन शामिल नहीं किया जाता.

यहां कुछ उदाहरण दिए गए हैं कि बुकिंग सर्वर, एक ही अनुरोध को कई बार प्रोसेस करने से कैसे रोकता है:

  • अगर एचटीटीपी रिस्पॉन्स CreateBooking सही है, तो उसमें बनाई गई बुकिंग शामिल होती है. कुछ मामलों में, बुकिंग के दौरान ही पेमेंट प्रोसेस कर दिया जाता है. अगर एक ही idempotency_token के साथ एक ही CreateBookingRequest दूसरी बार मिलता है, तो वही CreateBookingResponse वापस भेजना होगा. दूसरी बुकिंग नहीं की जाती है. साथ ही, अगर लागू हो, तो उपयोगकर्ता से सिर्फ़ एक बार शुल्क लिया जाता है.

आईडम्पोटेंसी की ज़रूरी शर्त, स्थिति में बदलाव करने वाले सभी तरीकों पर लागू होती है.