वेब पर पुष्टि करने वाला एपीआई

पुष्टि करने के मकसद से उपयोगकर्ताओं को रीडायरेक्ट करने के लिए, इंटिग्रेटर को एक वेब होस्ट लागू करना होगा. यह पुष्टि करने का तरीका अलग है, लेकिन यह Android की पुष्टि करने से मिलने वाले पुष्टि करने के मकसद के मुताबिक ही है. इस वेब होस्ट की एक मोबाइल-फ़्रेंडली वेबसाइट होनी चाहिए.

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

सर्वर को GET का इस्तेमाल करके एचटीटीपीएस प्रोटोकॉल लागू करना होगा. पाथ और होस्ट को इंटिग्रेटर तय करता है. इंटिग्रेटर के यूआरएल में 2,048 वर्ण होने चाहिए. इसमें स्कीम, होस्ट, पोर्ट, पाथ, और पैरामीटर शामिल हैं.

यूआरएल-कोड में बदलने से पहले, सभी पैरामीटर UTF-8 में एन्कोड किए जाएंगे.

अनुरोध

अनुरोध किए जाने पर, Google इन्हें यूआरएल पैरामीटर के तौर पर उपलब्ध कराता है:

फ़ील्ड
gspMajorVersion int

इस अनुरोध का मेजर वर्शन नंबर.

gspAuthenticationRequest AuthenticationRequest

पुष्टि करने का अनुरोध.

gspAssociationId string

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

gspCallbackUrl string

वह यूआरएल जिस पर उपयोगकर्ता को रीडायरेक्ट किया जाता है, ताकि Google पर पुष्टि की प्रक्रिया पूरी हो सके. यह मान यूआरएल कोड में बदला गया है.

जवाब

पुष्टि की प्रक्रिया पूरी होने के बाद, उपयोगकर्ता को एचटीटीपीएस जीईटी का इस्तेमाल करके gspCallbackUrl पर रीडायरेक्ट किया जाना चाहिए. इस यूआरएल में नीचे दिए गए क्वेरी पैरामीटर होने चाहिए:

फ़ील्ड
gspResult int

100
पुष्टि करने की प्रोसेस पूरी हो गई.
201 उपयोगकर्ता ने फ़्लो को मैन्युअल तरीके से रद्द कर दिया है और अब फ़्लो को रद्द कर दिया जाएगा.
202 किसी गंभीर वजह से पुष्टि नहीं हो सकी और फ़्लो को रद्द कर दिया जाना चाहिए.

gspAuthenticationResponse AuthenticationResponse

पुष्टि की गई.