लिंकिंग URL बनाने का एकमात्र तरीका अब
generateJWT नहीं है। यह अब भी काम करता है और यह पेज अब भी
इसे समझाता है, लेकिन नए इंटीग्रेशन के लिए
Link Session बनाना इस्तेमाल करें — इसमें किसी private key की ज़रूरत नहीं है, और आप
देख सकते हैं कि लिंक खोला गया या नहीं या समय समाप्त होने से पहले
उसे रद्द कर सकते हैं।दोनों एंडपॉइंट एक ही वैलिडेटर चलाते हैं, इसलिए इस पेज पर expiresIn, allowedSocial,
instagramLinkMethod, redirect, logout और Connect Accounts ईमेल के बारे में जो कुछ है वह दोनों पर
लागू होता है। generateJWT तीन छोटी छूटें रखता है जिन्हें नया एंडपॉइंट अस्वीकार करता है: allowedSocial
में अपरिचित नेटवर्क, X क्रेडेंशियल का केवल एक हिस्सा, और गैर-स्ट्रिंग redirect।लिंकिंग URL भेजना
प्रोफ़ाइल स्विच करना
विभिन्न प्रोफ़ाइल सत्रों के बीच स्विच करने के लिए (उदाहरण के लिए, कई प्रोफ़ाइल के साथ परीक्षण करते समय), आपको पहले वर्तमान प्रोफ़ाइल को लॉग आउट करना होगा। प्रोफ़ाइल स्विचिंग को सही ढंग से संभालने के तरीके पर निर्देशों के लिए Automatic Logout of a Profile Session देखें।Profile Key
profileKey बताता है कि लिंकिंग URL किस User Profile के लिए है। इसे Ayrshare डेवलपर डैशबोर्ड में उस प्रोफ़ाइल पर स्विच करके पाया जा सकता है।
Private Key अब इस्तेमाल नहीं होती। लिंकिंग URL साइन नहीं किए जाते, इसलिए किसी फ़ाइल से कुछ पढ़ने या अपने कोड में चिपकाने की ज़रूरत नहीं है।
privateKey अब भी स्वीकार किया जाता है और नज़रअंदाज़ कर दिया जाता है, इसलिए मौजूदा इंटीग्रेशन काम करते रहते हैं, और आपके Integration Package की private.key फ़ाइल अनुपयोगी छोड़ी जा सकती है।लिंकिंग URL बनाना
लिंकिंग URL बनाने का 1 मिनट का वीडियो। यह Link Sessions से पहले रिकॉर्ड किया गया था, इसलिए इसमें अब भी Private Key भेजते हुए दिखाया गया है; वह चरण अब ज़रूरी नहीं है।expiresIn देखें।
लिंकिंग URL खोलना
लिंकिंग URL को एक नए ब्राउज़र टैब, ब्राउज़र विंडो, या iOS पर View Controller में खोलें। आप नई विंडो या टैब के बंद करने या पुनर्निर्देशन को नियंत्रित कर सकते हैं।सोशल नेटवर्क URL को iFrame में खोलने या approved partner origin domain profile.ayrshare.com को अस्पष्ट करने की अनुमति नहीं देते हैं।
URL का सत्यापन
verify: true अब इस्तेमाल नहीं होता। यह स्वीकार किया जाता है और नज़रअंदाज़ कर दिया जाता है।
सत्यापित करने के लिए कोई साइन किया हुआ token नहीं है: लौटाए गए token को लिंकिंग पेज तब जाँचता है जब आपका उपयोगकर्ता URL खोलता है। पहले यह विकल्प आपकी Private Key से JWT को दोबारा पार्स करता था, ताकि URL भेजने से पहले ख़राब key पकड़ी जा सके। अब प्रवाह में कोई key न होने से, वह विफलता संभव ही नहीं है।
Postman में परीक्षण
पहले Postman में लिंकिंग URL निर्माण का परीक्षण करना अनुशंसित है। डैशबोर्ड के Primary Profile API Key पेज पर मिलने वाले Integration Package में एक नमूना Postman कॉन्फ़िग JSON फ़ाइल शामिल है। बस config फ़ाइल को Postman में इम्पोर्ट करें,profileKey body फ़ील्ड में अपनी Profile Key (Ayrshare डेवलपर डैशबोर्ड में उस प्रोफ़ाइल पर स्विच करके जिसका आप परीक्षण करना चाहते हैं) भरें, और नीले Send बटन पर क्लिक करें।
नमूना कॉन्फ़िग अब भी privateKey और domain पहले से भर देता है। privateKey नज़रअंदाज़ कर दिया जाता है, और domain को आप खाली कर सकते हैं, बशर्ते आपके अकाउंट पर एक से ज़्यादा लिंकिंग domain न हों।
आप Postman से कोड जेनरेट भी कर सकते हैं।
Instagram लिंक विधि
Instagram अकाउंट दो तरीकों से लिंक किए जा सकते हैं: सीधे Instagram Login के साथ, या connected Facebook Page के माध्यम से। जब कोई उपयोगकर्ता सोशल लिंकिंग पृष्ठ पर Instagram बटन क्लिक करता है तो कौन सा फ्लो शुरू होता है, यह सामान्य रूप से डैशबोर्ड में अकाउंट-वाइड Instagram Login सेटिंग द्वारा नियंत्रित होता है। generateJWT endpoint काinstagramLinkMethod बॉडी पैरामीटर आपको एकल लिंकिंग URL के लिए उस सेटिंग को ओवरराइड करने देता है:
उदाहरण के लिए, यदि आपका अकाउंट डिफ़ॉल्ट Facebook Page लिंकिंग है, तो निम्नलिखित केवल इस लिंकिंग सत्र के लिए सीधे Instagram Login को बाध्य करता है:
Instagram Link Method
- ओवरराइड केवल लौटाए गए URL से खोले गए लिंकिंग पृष्ठ पर लागू होता है। यह आपकी अकाउंट-वाइड Instagram Login सेटिंग को नहीं बदलता है और न ही अन्य लिंकिंग सत्रों को प्रभावित करता है।
- यदि
instagramLinkMethodको छोड़ दिया जाता है, तो लिंकिंग पृष्ठ आपकी अकाउंट-वाइड सेटिंग का उपयोग करता है, बिल्कुल पहले जैसा। - यदि एक अमान्य मान भेजा जाता है, तो मान्य मानों (
instagram,facebook) को सूचीबद्ध करते हुए एक400त्रुटि लौटाई जाती है। - ओवरराइड चुनने से पहले दो फ्लो के बीच फ़ीचर अंतर की समीक्षा करें — कुछ Instagram फ़ीचर, जैसे हैशटैग खोज और सहयोग, केवल Facebook Page प्रमाणीकरण के साथ उपलब्ध हैं।
JWT Expires In
यदि आप डिफ़ॉल्ट 5 मिनट से अधिक लिंक टाइमआउट चाहते हैं, तोexpiresIn फ़ील्ड शामिल करें।
उदाहरण के लिए, लिंकिंग URL को 30 मिनट के लिए मान्य सेट करने के लिए निम्नलिखित JSON भेजें:
JWT Expires In
एकीकरण
Bubble.io
यदि आप Bubble उपयोगकर्ता हैं, तो निर्देशों के लिए Bubble.io अनुभाग में Bubble में लिंकिंग URL बनाएँ देखें:Bubble linking URL
Mobile JWT
निम्नलिखित Swift, Flutter, और React Native मोबाइल कोड उदाहरण दिखाते हैं कि iOS डिवाइस पर सोशल लिंकिंग पृष्ठ कैसे लॉन्च करें।jwtURL String वेरिएबल को /generateJWT endpoint से मिलने वाले रिटर्न से बदलें।
Swift (iOS)
Swift में,UIViewController और SFSafariViewControllerDelegate का उपयोग करें।
हम WebView के उपयोग की अनुशंसा नहीं करते क्योंकि Facebook और Google जैसे कुछ सोशल नेटवर्क प्रमाणीकरण को ब्लॉक करते हैं।
Flutter (Dart)
Flutter (Dart) में,UIViewController या SFSafariViewController का कोई सीधा समकक्ष नहीं है।
हालाँकि, आप वेब URL खोलने के लिए url_launcher पैकेज का उपयोग करके समान कार्यक्षमता प्राप्त कर सकते हैं।
React Native
React Native में भीSFSafariViewController का कोई सीधा समकक्ष नहीं है, लेकिन आप expo-web-browser द्वारा प्रदान किए गए WebBrowser API के साथ समान परिणाम प्राप्त कर सकते हैं, जो सिस्टम ब्राउज़र के साथ कुकीज़ साझा करने वाली एक मॉडल ब्राउज़र विंडो में URL खोलता है। अन्यथा, आप Safari खोलने के लिए बिल्ट-इन React Native Linking फ़ंक्शन का उपयोग कर सकते हैं: await Linking.canOpenURL(jwtURL);
मोबाइल कोड उदाहरण
Connect Accounts Email
लंबे expire समय विकल्प के साथ, आप Ayrshare को अपने उपयोगकर्ताओं को सोशल लिंकेज पृष्ठ का लिंक ईमेल करवा भी सकते हैं।Connect Accounts JSON
उदाहरण के लिए निम्नलिखित JSONjohn@user.com पर ACME कंपनी नाम, संपर्क ईमेल support@mycompany.com, और terms और privacy policy के लिंक के साथ एक ईमेल भेजेगा:
Example Contact Email Request
Example Contact Email Response
Connect Accounts Email उदाहरण
यहाँ Connect Account लिंक के साथ एक ईमेल का उदाहरण है जो सोशल लिंकेज पृष्ठ खोलता है: ईमेल इस पते से आएगा:Social Connect Hub <connect@socialconnecthub.com>