मुख्य सामग्री पर जाएं
Errors मानक HTTP status codes के साथ लौटेंगी। Status codes इस प्रकार हैं:
  • 1xx: Informational - Transfer protocol-level जानकारी संप्रेषित करता है।
  • 2xx: Success - अनुरोध सफल था।
  • 3xx: Redirection - client को अनुरोध पूरा करने के लिए कुछ अतिरिक्त कार्रवाई करनी होगी।
  • 4xx: Client Error - client error के कारण अनुरोध विफल।
  • 5xx: Server Error - server error के कारण अनुरोध विफल।

​
200 Success

एक सफल अनुरोध किया गया था।

​
400 Bad Request

400 Bad Request error का अर्थ है कि server अनुरोध के साथ आगे बढ़ने में असमर्थ था। error का सबसे सामान्य कारण अनुरोध URL या body में खराब syntax है।

​
401 Unauthorized

401 Unauthorized errors आमतौर पर आपकी API कॉल के अनुरोध header में समस्या के कारण होती हैं, यानी आपने API कॉल करने के लिए वैध API key का उपयोग नहीं किया।

​
403 Access Denied

जब आपका ऐप्लिकेशन आपकी API key के साथ API कॉल करता है और अनुरोध की अनुमति नहीं है। यदि User Profile निलंबित है तो 403 भी लौटाया जा सकता है।

​
404 Resource Not Found

यह error तब होती है जब आपका ऐप्लिकेशन एक ऐसे API को कॉल करने या ऐसी entity प्राप्त करने का प्रयास करता है जो मौजूद नहीं है।

​
405 Method Not Allowed

यह error इंगित करती है कि आपके अनुरोध में HTTP protocol methods समर्थित नहीं हैं। समर्थित methods देखने के लिए API के documentation की जाँच करें।

​
429 Rate Limit

​
User Profile Rate Limits

प्रत्येक User Profile की 5-मिनट के अंतराल में 300 API अनुरोधों की rate limit है। आप प्रतिक्रिया headers के माध्यम से अपने rate limit उपयोग की निगरानी कर सकते हैं:
  • x-ratelimit-max: 5-मिनट की अवधि के लिए आपके अधिकतम अनुमत अनुरोध दिखाता है
  • x-ratelimit-count: दिखाता है कि आपने वर्तमान 5-मिनट की अवधि में कितने अनुरोध किए हैं
हम 429 error code प्रतिक्रियाओं की जाँच करने की अनुशंसा करते हैं। यदि आप 429 error देखते हैं, तो आप अपनी rate limit तक पहुँच गए हैं। rate limit को पार करने के बार-बार प्रयासों के परिणामस्वरूप User Profile निलंबित हो सकती है।एकाधिक user profiles के लिए rate limits को संभालने के बारे में अधिक जानें।

​
Platform Analytics Rate Limits

HTTP 429 तब भी लौटाया जा सकता है जब कोई सोशल नेटवर्क किसी विशिष्ट खाते के लिए analytics कॉल्स को throttle करता है — आपकी Ayrshare User Profile सीमाओं से स्वतंत्र रूप से। उस मामले में प्रतिक्रिया एक platform-specific Ayrshare error code वहन करती है (उदाहरण के लिए Facebook per-Page analytics throttles के लिए code: 444)। profile rate limit को platform-side throttle से अलग करने के लिए code फ़ील्ड का निरीक्षण करें, और user को दोबारा लिंक करने के लिए संकेत देने के बजाय backoff के साथ पुनः प्रयास करें।

​
User Profile Deletion Rate Limits

आप प्रति सेकंड 8 user profiles हटा सकते हैं। यदि आपको बल्क डिलीट की आवश्यकता है तो कृपया API कॉल्स को stagger करें।

​
Rate Limit Protection और Suspension Policy

हमारी सिस्टम अखंडता की सुरक्षा के लिए, हम स्वचालित निलंबन लागू करते हैं यदि कोई User Profile rate limits को बहुत बार पार कर जाती है। यह कैसे काम करता है: जब आप API अनुरोध करते हैं, तो आपको 5-मिनट की window को सावधानीपूर्वक प्रबंधित करना होगा। उदाहरण के लिए, यदि आप एक मिनट में 300 अनुरोध करते हैं, तो अतिरिक्त अनुरोध करने से पहले आपको चार और मिनट प्रतीक्षा करनी होगी। इस प्रतीक्षा अवधि के दौरान कोई भी अनुरोध 429 error प्रतिक्रिया को ट्रिगर करेगा। यदि कोई User Profile 24 घंटे की अवधि के भीतर 1,000 rate limit उल्लंघन (429 errors) जमा करती है, तो profile स्वचालित रूप से निलंबित हो जाएगी। 5-मिनट की प्रतीक्षा अवधि समाप्त होने के बाद, आप 5-मिनट की window में 300 प्रति की मानक सीमा तक अनुरोध करना फिर से शुरू कर सकते हैं।

​
500 Internal Server Error

500 Internal Server Error इंगित करता है कि Ayrshare एक आंतरिक error का अनुभव कर रहा है या प्रसंस्करण विफल हो गया।