अपने सोशल मीडिया अकाउंट्स कनेक्ट करें
अपने Ayrshare अकाउंट में लॉग इन करें या साइन अप करें। Social Account पृष्ठ पर, उन सोशल नेटवर्क्स पर क्लिक करें जिन्हें आप कनेक्ट करना चाहते हैं। कृपया सुनिश्चित करें कि आप सभी अनुमतियाँ प्रदान कर रहे हैं।
अपनी API Key प्राप्त करें
API endpoints तक पहुँच को अधिकृत करने के लिए एक API Key आवश्यक है। यह key आपके requests के header में उपयोग की जाती है, और इसके पहलेBearer कीवर्ड होना चाहिए।
आपकी API Key Ayrshare Dashboard के भीतर API Key पृष्ठ पर स्थित है। यदि आवश्यक हो, तो User Profiles पृष्ठ के माध्यम से अपने ‘Primary Profile’ पर स्विच करें।
वहाँ से, आप बाएँ हाथ के साइड पैनल में API Key पृष्ठ पा सकते हैं।

Bearer Token का उपयोग करके Header में API Key शामिल होनी चाहिए। साथ ही application/json का Content-Type भी शामिल करें।
Header
अपना पहला API पोस्ट भेजें
पोस्ट प्रकाशित करना
नीचे कोड उदाहरण दिए गए हैं जो दिखाते हैं कि विभिन्न प्रोग्रामिंग भाषाओं में हमारे API का उपयोग करके पोस्ट कैसे किया जाए। और भी आसान इंटीग्रेशन के लिए, आप हमारे पूर्व-निर्मित SDK पैकेजों में से किसी एक का उपयोग कर सकते हैं। पोस्ट करने के लिए, आपको आवश्यकता होगी:- प्रमाणीकरण के लिए आपकी API Key।
- आपके पोस्ट की टेक्स्ट सामग्री।
- वे सोशल मीडिया प्लेटफ़ॉर्म्स जिन पर आप पोस्ट करना चाहते हैं (केवल उन्हीं प्लेटफ़ॉर्म्स को शामिल करें जिन्हें आपने लिंक किया है)।
- वैकल्पिक: कोई भी छवियों या वीडियो के URLs जिन्हें आप शामिल करना चाहते हैं।
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
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 के साथ उपयोग किया जाता है।
isVideo: true और isPortraitVideo: true जोड़कर।
/post endpoint के साथ उपयोग किया जाता है।
यादृच्छिक टिप्पणी
टिप्पणी प्रकाशित करने के परीक्षण के लिएrandomComment: true जोड़कर एक यादृच्छिक टिप्पणी भेजें।
/comment endpoint के साथ उपयोग किया जाता है।
