Twitter API गाइड

यह सेवा एकीकृत Twitter REST API देती है। कॉल करने वाले को एकसमान X API v2-शैली उत्तर संरचनाएँ मिलती हैं।

/v1/twitter

प्रमाणीकरण

सभी Twitter API एंडपॉइंट में Bearer Token प्रमाणीकरण आवश्यक है।

Authorization: Bearer YOUR_API_KEY

आधार पथ

अपने API Base URL के अंतर्गत इन सापेक्ष पथों को कॉल करें।

GET https://api.apihop.ai/v1/twitter/users
GET https://api.apihop.ai/v1/twitter/users/{id}
GET https://api.apihop.ai/v1/twitter/users/{id}/tweets

उत्तर संरचना

सफल Twitter API उत्तर success/data में नहीं लिपटे होते; वे सीधे मानकीकृत data, includes और meta फ़ील्ड लौटाते हैं।

समर्थित क्षमताएँ

सुझाया क्रम

1. केवल username हो तो पहले उपयोगकर्ता नाम से उपयोगकर्ता पाने वाला एंडपॉइंट कॉल करें और data.id पढ़ें।
2. उपयोगकर्ता टाइमलाइन कॉल करने के लिए data.id लें।
3. टाइमलाइन उत्तर में लेखक प्रोफ़ाइल डेटा चाहिए तो expansions=author_id दें।

मानकीकरण नियम

• उपयोगकर्ता एंडपॉइंट एक उपयोगकर्ता ऑब्जेक्ट लौटाते हैं: { "data": { ... } }
• टाइमलाइन एंडपॉइंट ट्वीट ऐरे लौटाते हैं: { "data": [ ... ], "meta": { ... } }
• expansions=author_id माँगने पर टाइमलाइन उत्तर में includes.users आता है
• user.fields और tweet.fields वैकल्पिक फ़ील्ड चयन नियंत्रित करते हैं
• उपयोगकर्ता ऑब्जेक्ट हमेशा id, name और username रखते हैं
• ट्वीट ऑब्जेक्ट हमेशा id और text रखते हैं

वैकल्पिक फ़ील्ड

user.fields

समर्थित मानकीकृत उपयोगकर्ता फ़ील्ड:

• created_at
• description
• entities
• location
• pinned_tweet_id
• profile_banner_url
• profile_image_url
• protected
• public_metrics
• url
• verified
• verified_type

tweet.fields

समर्थित मानकीकृत ट्वीट फ़ील्ड:

• attachments
• author_id
• conversation_id
• created_at
• edit_history_tweet_ids
• entities
• in_reply_to_user_id
• lang
• possibly_sensitive
• public_metrics
• referenced_tweets
• source

डीबगिंग

• हर उत्तर में X-Request-Id होता है
• कॉल विफल, परिणाम असामान्य या सेवा से दर सीमा मिलने पर इसे दर्ज करें
• बिलिंग प्रश्नों के लिए X-Request-Id और अनुरोध समय रखें

एंडपॉइंट