Skip to main content
generateJWT endpoint एकल User Profile के लिए सोशल नेटवर्क लिंकिंग URL उत्पन्न करता है। अधिक विवरण के लिए Business Plan and Launch Plan API integration देखें।
लिंकिंग URL बनाने का एकमात्र तरीका अब generateJWT नहीं है। यह अब भी काम करता है और यह पेज अब भी इसे समझाता है, लेकिन नए इंटीग्रेशन के लिए Link Session बनाना इस्तेमाल करें — इसमें किसी private key की ज़रूरत नहीं है, और आप देख सकते हैं कि लिंक खोला गया या नहीं या समय समाप्त होने से पहले उसे रद्द कर सकते हैं।दोनों एंडपॉइंट एक ही वैलिडेटर चलाते हैं, इसलिए इस पेज पर expiresIn, allowedSocial, instagramLinkMethod, redirect, logout और Connect Accounts ईमेल के बारे में जो कुछ है वह दोनों पर लागू होता है। generateJWT तीन छोटी छूटें रखता है जिन्हें नया एंडपॉइंट अस्वीकार करता है: allowedSocial में अपरिचित नेटवर्क, X क्रेडेंशियल का केवल एक हिस्सा, और गैर-स्ट्रिंग redirect

लिंकिंग URL भेजना

लिंकिंग URL आपके उपयोगकर्ता को उनके प्रोफ़ाइल में साइन इन कर देता है, इसलिए इसे पासवर्ड की तरह मानें। इसे भरोसेमंद चैनल से भेजें, इसे लॉग न करें, और किसी तीसरे पक्ष को न दें। यह अपनी पूरी अवधि तक काम करता रहता है, इसलिए रीलोड या OAuth री-ट्राई चलता है — लेकिन हर लिंक केवल एक उपयोगकर्ता को भेजें, और हर व्यक्ति के लिए अलग लिंक बनाएँ।

प्रोफ़ाइल स्विच करना

विभिन्न प्रोफ़ाइल सत्रों के बीच स्विच करने के लिए (उदाहरण के लिए, कई प्रोफ़ाइल के साथ परीक्षण करते समय), आपको पहले वर्तमान प्रोफ़ाइल को लॉग आउट करना होगा। प्रोफ़ाइल स्विचिंग को सही ढंग से संभालने के तरीके पर निर्देशों के लिए 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 भेजते हुए दिखाया गया है; वह चरण अब ज़रूरी नहीं है।
लिंकिंग URL 5 मिनट के लिए मान्य है। 5 मिनट के बाद आपको एक नया लिंकिंग URL उत्पन्न करना होगा। अतिरिक्त विकल्पों के लिए Max Pack 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 बटन क्लिक करने से उस सत्र की अवधि के लिए अनुरोधित फ्लो शुरू हो जाएगा — Instagram/Facebook प्राधिकरण पुनर्निर्देशन के दौरान भी। कुछ बातें जानने योग्य हैं:
  • ओवरराइड केवल लौटाए गए URL से खोले गए लिंकिंग पृष्ठ पर लागू होता है। यह आपकी अकाउंट-वाइड Instagram Login सेटिंग को नहीं बदलता है और न ही अन्य लिंकिंग सत्रों को प्रभावित करता है।
  • यदि instagramLinkMethod को छोड़ दिया जाता है, तो लिंकिंग पृष्ठ आपकी अकाउंट-वाइड सेटिंग का उपयोग करता है, बिल्कुल पहले जैसा।
  • यदि एक अमान्य मान भेजा जाता है, तो मान्य मानों (instagram, facebook) को सूचीबद्ध करते हुए एक 400 त्रुटि लौटाई जाती है।
  • ओवरराइड चुनने से पहले दो फ्लो के बीच फ़ीचर अंतर की समीक्षा करें — कुछ Instagram फ़ीचर, जैसे हैशटैग खोज और सहयोग, केवल Facebook Page प्रमाणीकरण के साथ उपलब्ध हैं।

JWT Expires In

यदि आप डिफ़ॉल्ट 5 मिनट से अधिक लिंक टाइमआउट चाहते हैं, तो expiresIn फ़ील्ड शामिल करें। उदाहरण के लिए, लिंकिंग URL को 30 मिनट के लिए मान्य सेट करने के लिए निम्नलिखित JSON भेजें:
JWT Expires In
यह आपको अपने उपयोगकर्ताओं को लिंक ईमेल करने की अनुमति देता है, बजाय उनके आपके ऐप या प्लेटफ़ॉर्म पर जाने के। एक सामान्य उपयोग-मामला यह है कि जब आपके उपयोगकर्ता को सोशल अकाउंट को फिर से कनेक्ट करने की आवश्यकता होती है, तो आप उन्हें अपने प्लेटफ़ॉर्म पर नेविगेट करने के बजाय सोशल अकाउंट को सीधे फिर से लिंक करने के लिए JWT लिंक ईमेल कर सकते हैं।
अपनी सुरक्षा टीम के साथ समीक्षा करें कि आपका व्यवसाय JWT को कितने समय तक जीवित रखना चाहता है। लंबे expire समय एक अनधिकृत पक्ष द्वारा लिंक तक पहुँच बनाने का अतिरिक्त जोखिम पैदा करते हैं।

एकीकरण

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

उदाहरण के लिए निम्नलिखित JSON john@user.com पर ACME कंपनी नाम, संपर्क ईमेल support@mycompany.com, और terms और privacy policy के लिंक के साथ एक ईमेल भेजेगा:
Example Contact Email Request
यदि ईमेल और expire समय सेट किया गया था तो प्रतिक्रिया में निम्नलिखित शामिल होगा:
Example Contact Email Response

Connect Accounts Email उदाहरण

यहाँ Connect Account लिंक के साथ एक ईमेल का उदाहरण है जो सोशल लिंकेज पृष्ठ खोलता है: ईमेल इस पते से आएगा: Social Connect Hub <connect@socialconnecthub.com>