API एकरूपता

X API v2 एंडपॉइंट्स में एकसमान पैटर्न

X API v2 को सभी एंडपॉइंट्स में एकसमान पैटर्न के साथ डिज़ाइन किया गया है। एक बार आप समझ लें कि कोई एक एंडपॉइंट कैसे काम करता है, तो वही पैटर्न हर जगह लागू होते हैं।

---

सुसंगत पैटर्न

URL संरचना

सभी v2 एंडपॉइंट एक अनुमानित पैटर्न का पालन करते हैं:

/version/resource/{id}?parameters
/version/resource/verb?parameters

उदाहरण:

/2/tweets/1234567890                    # एक विशिष्ट पोस्ट प्राप्त करें
/2/tweets/search/recent                 # हाल की पोस्ट्स खोजें
/2/users/by/username/xdevelopers        # उपयोगकर्ता नाम द्वारा उपयोगकर्ता प्राप्त करें
/2/users/1234/followers                 # उपयोगकर्ता के फ़ॉलोअर्स प्राप्त करें

रिस्पॉन्स संरचना

सभी रिस्पॉन्स एक ही शीर्ष-स्तरीय संरचना का उपयोग करते हैं:

{
  "data": { ... },       // प्राथमिक ऑब्जेक्ट(s)
  "includes": { ... },   // विस्तारित ऑब्जेक्ट
  "meta": { ... },       // पेजिनेशन, गणना
  "errors": [ ... ]      // आंशिक त्रुटियाँ (यदि कोई हों)
}

ID का प्रारूप

विभिन्न भाषाओं के साथ संगतता सुनिश्चित करने के लिए सभी ID स्ट्रिंग के रूप में लौटाई जाती हैं:

{
  "id": "1234567890123456789",
  "author_id": "2244994945"
}

---

फ़ील्ड्स और expansions

एक ही फ़ील्ड्स और expansions पैरामीटर हर जगह एक जैसे तरीके से काम करते हैं:

ऑब्जेक्ट	फ़ील्ड्स पैरामीटर	इन सभी में काम करता है
पोस्ट	tweet.fields	पोस्ट्स लौटाने वाले सभी एंडपॉइंट्स
उपयोगकर्ता	user.fields	उपयोगकर्ताओं को लौटाने वाले सभी एंडपॉइंट्स
मीडिया	media.fields	मीडिया expansions वाले सभी एंडपॉइंट्स
पोल	poll.fields	पोल expansions वाले सभी एंडपॉइंट्स
स्थान	place.fields	स्थान expansions वाले सभी एंडपॉइंट्स

---

ऑब्जेक्ट स्कीमा

एक ही ऑब्जेक्ट type में हमेशा वही फ़ील्ड्स होते हैं, चाहे उसे कोई भी एंडपॉइंट रिटर्न करे:

• search से मिला पोस्ट, lookup से मिले पोस्ट के समान फ़ील्ड्स रखता है
• followers से मिला User, search से मिले User के समान फ़ील्ड्स रखता है
• Expanded ऑब्जेक्ट्स अपने standalone समकक्षों से मेल खाते हैं

---

प्रमाणीकरण

सभी एंडपॉइंट एक ही प्रमाणीकरण विधियों का उपयोग करते हैं:

विधि	हेडर फ़ॉर्मैट
बेयरर टोकन	Authorization: Bearer {token}
OAuth 1.0a	Authorization: OAuth {parameters}
OAuth 2.0	Authorization: Bearer {user_token}

---

त्रुटि प्रबंधन

त्रुटियाँ एक समान प्रारूप में होती हैं:

{
  "title": "Invalid Request",
  "detail": "The query parameter is missing",
  "type": "https://api.x.com/2/problems/invalid-request"
}

सभी error type देखें →

---

पेजिनेशन

सभी पेजिनेट किए गए एंडपॉइंट एक ही टोकन सिस्टम का उपयोग करते हैं:

Parameter	Description
max_results	प्रति पेज परिणाम
pagination_token	next_token या previous_token से मिला टोकन

पेजिनेशन के बारे में और जानें →

---

नामकरण परंपराएं

• अमेरिकी अंग्रेज़ी वर्तनी (favorites, न कि favourites)
• फ़ील्ड नामों के लिए snake_case (author_id, created_at)
• सुसंगत शब्दावली (retweet_count, फ़ील्ड्स में repost_count नहीं)

---

रिक्त मान

जिन फ़ील्ड्स का कोई मान नहीं होता, उन्हें null के रूप में लौटाने के बजाय शामिल नहीं किया जाता है:

// बिना बायो वाला उपयोगकर्ता
{
  "id": "1234",
  "name": "Example User",
  "username": "example"
  // "description" छोड़ा गया है, null नहीं
}

---

इकाई की संगति

entities ऑब्जेक्ट में केवल वे इकाइयाँ शामिल होती हैं, जिन्हें टेक्स्ट से पार्स किया गया है:

• urls
• hashtags
• mentions
• cashtags

मीडिया और पोल attachments में होते हैं, entities में नहीं।

---

आपके लिए इसका क्या मतलब है

एक बार सीखें, हर जगह इस्तेमाल करें

जो पैटर्न आप एक एंडपॉइंट पर सीखते हैं, वे सभी एंडपॉइंट्स पर लागू होते हैं।

अनुमानित रिस्पॉन्स

पूरे API में समान object types की संरचना एक जैसी रहती है।

ज़्यादा सरल कोड

सामान्य पैटर्न के लिए पुन: प्रयोज्य functions बनाएँ।

आसान डिबगिंग

एकसमान error formats समस्या-निवारण को आसान बनाते हैं।

---

असंगतियों की रिपोर्ट करें

कोई असंगति मिली? हमें बताएँ:

• Developer Forum
• Developer Feedback