Tenor के V1 API से माइग्रेट करने का तरीका

Tenor के V1 API का इस्तेमाल करने वाले मौजूदा इंटिग्रेशन के लिए, V2 पर माइग्रेट करने के लिए इस पेज पर दिया गया तरीका अपनाएं.

V2 एपीआई पासकोड पाना

V1 वर्शन की जगह V2 एपीआई कुंजी पाने के लिए, क्विकस्टार्ट गाइड के सेटअप चरण में दिए गए निर्देशों का पालन करें.

V2 डोमेन पर अपडेट करना

अपने एपीआई डोमेन को https://tenor.googleapis.com/v2/ पर अपडेट करें. Tenor का V2 API सिर्फ़ एचटीटीपीएस कनेक्शन के साथ काम करता है. कॉन्टेंट के लिए, पक्का करें कि आपका ऐप्लिकेशन, https://media.tenor.com और https://c.tenor.com से कॉन्टेंट डाउनलोड करने की सुविधा देता हो.

उदाहरण के लिए, मान लें कि आपने इनमें से किसी V1 डोमेन पर एपीआई कॉल किया है:

  • https://api.tenor.com/v1/search?<parameters>
  • https://g.tenor.com/v1/search?<parameters>

कॉल को V2 पर अपडेट करने के लिए, उन्हें https://tenor.googleapis.com/v2/search?<parameters> पर बदलें.

एंडपॉइंट में बदलाव

ज़्यादातर एपीआई एंडपॉइंट पैरामीटर में कोई बदलाव नहीं किया गया है. ये पैरामीटर, V1 में दिए गए पैरामीटर के जैसे ही हैं. इसके कुछ खास अपवाद हैं:

  1. Tenor का Search endpoint अब searchfilter पैरामीटर के ज़रिए स्टिकर खोजने की सुविधा देता है.
  2. एपीआई कॉल पर client_key और country पैरामीटर शामिल करें.
  3. media_filter पैरामीटर अब पहले से सेट किए गए एनम के बजाय, कॉमा लगाकर अलग किए गए फ़ॉर्मैट की सूची लेता है.
  4. Categories endpoint अब type पैरामीटर के लिए, featured और trending के साथ काम करता है.
  5. एपीआई अब anon_id पैरामीटर के साथ काम नहीं करता.
  6. जब अनुरोध करने के लिए नतीजों के और पेज नहीं होते हैं, तो एपीआई से मिले रिस्पॉन्स का next फ़ील्ड अब "0" के बजाय एक खाली स्ट्रिंग होता है.

उपलब्ध एंडपॉइंट में ये बदलाव किए गए हैं:

  1. ट्रेंडिंग एंडपॉइंट अब काम नहीं करता. इसके बजाय, हमारा सुझाव है कि आप चुनिंदा एंडपॉइंट का इस्तेमाल करें.
  2. GIF एंडपॉइंट का नाम बदलकर पोस्ट एंडपॉइंट कर दिया गया है.
  3. रैंडम GIF एंडपॉइंट को खोज एंडपॉइंट में शामिल किया गया है. इसके लिए, random पैरामीटर का इस्तेमाल किया गया है.

जवाब देने वाले ऑब्जेक्ट और गड़बड़ी से जुड़े बदलाव

  • GIF ऑब्जेक्ट का नाम बदलकर Response ऑब्जेक्ट कर दिया गया है.
  • जवाब ऑब्जेक्ट में, media फ़ील्ड का नाम बदलकर media_formats कर दिया गया है. media_formats की वैल्यू अब मैप { CONTENT_FORMAT : MEDIA_OBJECT } है, न कि मैप की कोई ऐरे.
  • कॉन्टेंट के थंबनेल की झलक दिखाने वाली सुविधा को, हर कॉन्टेंट फ़ॉर्मैट के लिए मीडिया ऑब्जेक्ट से हटाकर, उसके फ़ॉर्मैट में जोड़ दिया गया है. ये जवाब ऑब्जेक्ट में मौजूद media_formats फ़ील्ड में उपलब्ध होते हैं.
  • जब रिस्पॉन्स ऑब्जेक्ट में कोई और नतीजा नहीं होता है, तो next फ़ील्ड, "0" के बजाय एक खाली स्ट्रिंग "" होता है.
  • Tenor API वाली गड़बड़ियों के कोड को Google के स्टैंडर्ड एपीआई वाले गड़बड़ी के कोड में माइग्रेट कर दिया गया है.