मुख्य सामग्री पर जाएं
यह गाइड एक ही कंपनी को सेटअप करने के लिए है। कई उपयोगकर्ताओं वाले Business और Enterprise Plan सब्सक्रिप्शन के लिए, एक व्यक्तिगत इंटीग्रेशन गाइड प्रदान की जाती है।

अपने सोशल मीडिया अकाउंट्स कनेक्ट करें

अपने Ayrshare अकाउंट में लॉग इन करें या साइन अप करें। Social Account पृष्ठ पर, उन सोशल नेटवर्क्स पर क्लिक करें जिन्हें आप कनेक्ट करना चाहते हैं। कृपया सुनिश्चित करें कि आप सभी अनुमतियाँ प्रदान कर रहे हैं।

Facebook Linking Example

अपनी API Key प्राप्त करें

API endpoints तक पहुँच को अधिकृत करने के लिए एक API Key आवश्यक है। यह key आपके requests के header में उपयोग की जाती है, और इसके पहले Bearer कीवर्ड होना चाहिए। आपकी API Key Ayrshare Dashboard के भीतर API Key पृष्ठ पर स्थित है। यदि आवश्यक हो, तो User Profiles पृष्ठ के माध्यम से अपने ‘Primary Profile’ पर स्विच करें। वहाँ से, आप बाएँ हाथ के साइड पैनल में API Key पृष्ठ पा सकते हैं। API Key प्रत्येक API call में Bearer Token का उपयोग करके Header में API Key शामिल होनी चाहिए। साथ ही application/json का Content-Type भी शामिल करें।
Header
अधिक जानकारी के लिए Authorization देखें।

अपना पहला API पोस्ट भेजें

पोस्ट प्रकाशित करना

नीचे कोड उदाहरण दिए गए हैं जो दिखाते हैं कि विभिन्न प्रोग्रामिंग भाषाओं में हमारे API का उपयोग करके पोस्ट कैसे किया जाए। और भी आसान इंटीग्रेशन के लिए, आप हमारे पूर्व-निर्मित SDK पैकेजों में से किसी एक का उपयोग कर सकते हैं। पोस्ट करने के लिए, आपको आवश्यकता होगी:
  • प्रमाणीकरण के लिए आपकी API Key
  • आपके पोस्ट की टेक्स्ट सामग्री।
  • वे सोशल मीडिया प्लेटफ़ॉर्म्स जिन पर आप पोस्ट करना चाहते हैं (केवल उन्हीं प्लेटफ़ॉर्म्स को शामिल करें जिन्हें आपने लिंक किया है)।
  • वैकल्पिक: कोई भी छवियों या वीडियो के URLs जिन्हें आप शामिल करना चाहते हैं।
सभी उदाहरण /post endpoint का उपयोग करते हैं। आइए कुछ सैंपल कोड देखें:
X/Twitter पर पोस्ट कर रहे हैं? X के लिए आपके स्वयं के API credentials आवश्यक हैं। अपने request में 2 BYO headers (X-Twitter-OAuth1-Api-Key और X-Twitter-OAuth1-Api-Secret) जोड़ें। यह प्रति Ayrshare अकाउंट एक बार का सेटअप है, और वही key pair प्रत्येक sub-profile / end-user के लिए काम करता है। विवरण के लिए सेटअप गाइड देखें।
बधाई हो! आपने अभी-अभी अपना पहला पोस्ट भेजा है।

पोस्ट रिस्पॉन्स

जब हमारा API आपकी पोस्ट को सफलतापूर्वक process करता है, तो आपको “success” के status के साथ एक response प्राप्त होगा। response में शामिल हैं:
  • status: API call की समग्र स्थिति (“success” या “error”)
  • errors: आने वाली किसी भी errors की array (सफल होने पर खाली)
  • postIds: प्लेटफ़ॉर्म-विशिष्ट विवरण वाले objects की array:
    • प्लेटफ़ॉर्म का नाम
    • उस प्लेटफ़ॉर्म पर पोस्ट ID
    • पोस्ट देखने के लिए URL
    • अतिरिक्त प्लेटफ़ॉर्म-विशिष्ट जानकारी
postIds array में प्रत्येक प्लेटफ़ॉर्म का अपना status होगा, जिससे आप यह सत्यापित कर सकते हैं कि किन प्लेटफ़ॉर्म्स ने आपके पोस्ट को सफलतापूर्वक प्राप्त किया। यह सुनिश्चित करने के लिए अपने सोशल मीडिया पृष्ठ जाँच करें कि पोस्ट सफलतापूर्वक process हुआ और लाइव है। ध्यान दें कि कुछ प्लेटफ़ॉर्म्स पर पोस्ट सार्वजनिक रूप से दिखने में थोड़ी देरी हो सकती है। यहाँ एक सैंपल response है:
Post Response
Node.js, Python, PHP, Golang, C#, और Ruby में सोशल मीडिया API कॉल करने के अधिक कोड उदाहरण, और साथ ही अन्य शानदार क्षमताएँ देखें:

Post

थोड़ी गहराई में जाना

आइए इस API call को करने पर जो हुआ, उसकी प्रक्रिया को समझते हैं।
1

Header सेट करें

हमने Header Authorization bearer token (API Key) और json का content type सेट किया।
2

एक Body Object बनाएँ

इसके बाद, हमने एक body object बनाया:
  • टेक्स्ट “Today is a great day!” युक्त पोस्ट।
  • Facebook, Instagram, और LinkedIn के सोशल नेटवर्क प्लेटफ़ॉर्म्स। आपको केवल उन्हीं प्लेटफ़ॉर्म्स को शामिल करना चाहिए जिन्हें आपने Social Linkage Page में लिंक किया है।
  • mediaUrls में एक छवि जोड़ी।
3

/post Endpoint को कॉल करें

सब कुछ HTTP POST के रूप में /post endpoint पर भेजा।

जाने से पहले, कुछ बेहतरीन प्रथाएँ

दस्तावेज़ पढ़ें

हम विस्तृत और अद्यतन दस्तावेज़ीकरण बनाए रखते हैं। चूँकि आप पहले से यहाँ हैं, बाएँ नेविगेशन में डॉक्स के अनुभागों को देखने में कुछ समय बिताएँ।

Error Codes महत्वपूर्ण हैं

आपको उन्हें हैंडल करने की आवश्यकता है ताकि आपके उपयोगकर्ताओं का अनुभव शानदार हो।

Errors

अपनी API Key सुरक्षित रखें

हम सुरक्षा को बहुत गंभीरता से लेते हैं, और आपको भी लेनी चाहिए। Ayrshare और आपके सोशल मीडिया अकाउंट्स के बीच कनेक्शन पर आपका पूरा नियंत्रण है। एक बार जब अकाउंट्स कनेक्ट हो जाते हैं, तो Ayrshare API key वह तरीका बन जाती है जिससे आप प्रमाणीकरण करते हैं। कृपया इस key को गुप्त और सुरक्षित रखें।

टेस्ट पोस्ट प्रकाशित करें

आप /post endpoint में randomPost, randomMediaUrl, और isLandscapeVideo या isPortraitVideo parameters का उपयोग करके यादृच्छिक उद्धरण, छवि, या वीडियो के साथ टेस्ट पोस्ट प्रकाशित कर सकते हैं। यदि आप randomPost का उपयोग करते हैं, तो post parameter आवश्यक नहीं है।
ये पोस्ट आपके सोशल मीडिया पृष्ठों पर लाइव हैं, इसलिए यदि उचित हो, तो टेस्टिंग के बाद उन्हें हटा दें।

यादृच्छिक उद्धरण

पोस्ट प्रकाशित करने के परीक्षण के लिए randomPost: true जोड़कर एक यादृच्छिक उद्धरण भेजें। /post endpoint के साथ उपयोग किया जाता है।

यादृच्छिक छवि

randomMediaUrl: true जोड़कर एक यादृच्छिक छवि भेजें। /post endpoint के साथ उपयोग किया जाता है।

यादृच्छिक वीडियो

isVideo: true और isLandscapeVideo: true जोड़कर एक यादृच्छिक landscape वीडियो भेजें। वीडियो मानक landscape आकार का होगा। /post endpoint के साथ उपयोग किया जाता है।
TikTok या Facebook/Instagram Reels के लिए आवश्यक एक यादृच्छिक portrait वीडियो भेजें, isVideo: true और isPortraitVideo: true जोड़कर। /post endpoint के साथ उपयोग किया जाता है।

यादृच्छिक टिप्पणी

टिप्पणी प्रकाशित करने के परीक्षण के लिए randomComment: true जोड़कर एक यादृच्छिक टिप्पणी भेजें। /comment endpoint के साथ उपयोग किया जाता है।

उदाहरण cURL Call

एक यादृच्छिक उद्धरण और portrait वीडियो भेजें।

अपने API Calls का परीक्षण करने के लिए Postman का उपयोग करें

Postman API calls का परीक्षण करने के लिए एक अद्भुत टूल है। आप एक दर्जन से अधिक भाषाओं में कोड भी उत्पन्न कर सकते हैं।

डेमो कोड

यदि आप React और NodeJS में सैंपल डेमो प्रोजेक्ट की तलाश में हैं, तो कृपया इस GitHub रिपॉज़िटरी को देखें:

Github Social Posting Demo App

सामान्य समस्या निवारण

कभी-कभी चीजें ठीक नहीं होतीं, इसलिए यहाँ हमारे सहायता केंद्र में थोड़ी मदद है।

Troubleshooting

मदद के लिए हमसे संपर्क करें

हम मदद के लिए यहाँ हैं, इसलिए कृपया नीचे दाएँ कोने में चैट का उपयोग करें या हमें ईमेल करें