एकीकरण मार्गदर्शिका

यह मार्गदर्शिका उन प्रमुख अवधारणाओं को समझाती है जिनकी आपको पोस्ट लुकअप एंडपॉइंट्स को अपने एप्लिकेशन में एकीकृत करने के लिए आवश्यकता है।

प्रमाणीकरण

सभी X API v2 एंडपॉइंट के लिए प्रमाणीकरण आवश्यक है। अपनी ज़रूरत के अनुसार उपयुक्त विधि चुनें:

विधि	किसके लिए सबसे उपयुक्त	क्या प्राइवेट मेट्रिक्स तक पहुंच मिलती है?
OAuth 2.0 App-Only	सर्वर-टू-सर्वर, सार्वजनिक डेटा	नहीं
PKCE के साथ OAuth 2.0 Authorization Code	उपयोगकर्ता-मुखी ऐप्स	हाँ (अधिकृत उपयोगकर्ता के पोस्ट्स के लिए)
OAuth 1.0a User Context	लीगेसी इंटीग्रेशन	हाँ (अधिकृत उपयोगकर्ता के पोस्ट्स के लिए)

केवल ऐप प्रमाणीकरण

सार्वजनिक पोस्ट डेटा के लिए, बेयरर टोकन का उपयोग करें:

cURL

curl "https://api.x.com/2/tweets/1234567890" \
  -H "Authorization: Bearer $BEARER_TOKEN"

from xdk import Client

client = Client(bearer_token="YOUR_BEARER_TOKEN")

# id के आधार पर एक पोस्ट प्राप्त करें
response = client.posts.get("1234567890")
print(response.data)

User Context प्रमाणीकरण

निजी मेट्रिक्स तक पहुँचने के लिए, पोस्ट के लेखक की ओर से प्रमाणीकरण करें:

निम्नलिखित फ़ील्ड्स के लिए User Context प्रमाणीकरण आवश्यक है:

tweet.fields.non_public_metrics
tweet.fields.promoted_metrics
tweet.fields.organic_metrics
media.fields.non_public_metrics
media.fields.promoted_metrics
media.fields.organic_metrics

फ़ील्ड्स और expansions

X API v2 डिफ़ॉल्ट रूप से न्यूनतम डेटा रिटर्न करता है। आपको जो चाहिए, ठीक वही अनुरोध करने के लिए fields और expansions का उपयोग करें।

डिफ़ॉल्ट रिस्पॉन्स

{
  "data": {
    "id": "1234567890",
    "text": "Hello world!",
    "edit_history_tweet_ids": ["1234567890"]
  }
}

उपलब्ध फ़ील्ड्स

tweet.fields

फ़ील्ड	विवरण
`created_at`	पोस्ट बनाने का टाइमस्टैम्प
`author_id`	लेखक की उपयोगकर्ता ID
`public_metrics`	लाइक, रीट्वीट, जवाब और कोट की संख्या
`entities`	हैशटैग, मेंशन, URL, कैशटैग
`attachments`	मीडिया कुंजियाँ, पोल ID
`conversation_id`	थ्रेड पहचानकर्ता
`context_annotations`	विषय/इकाई वर्गीकरण
`in_reply_to_user_id`	वह उपयोगकर्ता जिसे जवाब दिया जा रहा है
`lang`	पता लगाई गई भाषा
`source`	पोस्टिंग क्लाइंट
`possibly_sensitive`	संवेदनशील सामग्री का फ़्लैग
`reply_settings`	कौन जवाब दे सकता है

user.fields (author_id expansion आवश्यक)

फ़ील्ड	विवरण
`username`	@handle
`name`	डिस्प्ले नाम
`profile_image_url`	अवतार URL
`verified`	सत्यापन स्थिति
`description`	परिचय
`public_metrics`	फ़ॉलोअर/फ़ॉलोइंग की संख्या
`created_at`	खाता बनाने की तारीख

media.fields (attachments.media_keys expansion आवश्यक)

फ़ील्ड	विवरण
`url`	मीडिया URL
`preview_image_url`	थंबनेल URL
`type`	photo, video, animated_gif
`duration_ms`	वीडियो की अवधि
`height`, `width`	आयाम
`alt_text`	एक्सेसिबिलिटी टेक्स्ट

फ़ील्ड्स के साथ उदाहरण

cURL

curl "https://api.x.com/2/tweets/1234567890?\
tweet.fields=created_at,public_metrics,entities&\
expansions=author_id,attachments.media_keys&\
user.fields=username,verified&\
media.fields=url,type" \
  -H "Authorization: Bearer $BEARER_TOKEN"

from xdk import Client

client = Client(bearer_token="YOUR_BEARER_TOKEN")

# अतिरिक्त फ़ील्ड्स और expansions के साथ पोस्ट प्राप्त करें
response = client.posts.get(
    "1234567890",
    tweet_fields=["created_at", "public_metrics", "entities"],
    expansions=["author_id", "attachments.media_keys"],
    user_fields=["username", "verified"],
    media_fields=["url", "type"]
)

print(response.data)
print(response.includes)  # इसमें विस्तारित user और media ऑब्जेक्ट शामिल हैं

import { Client } from "@xdevplatform/xdk";

const client = new Client({ bearerToken: "YOUR_BEARER_TOKEN" });

const response = await client.posts.get("1234567890", {
  tweetFields: ["created_at", "public_metrics", "entities"],
  expansions: ["author_id", "attachments.media_keys"],
  userFields: ["username", "verified"],
  mediaFields: ["url", "type"],
});

console.log(response.data);
console.log(response.includes); // इसमें विस्तारित user और media ऑब्जेक्ट शामिल हैं

पोस्ट संपादन

पोस्ट्स को बनाए जाने के 30 मिनट के भीतर अधिकतम 5 बार संपादित किया जा सकता है।

यह कैसे काम करता है

हर संपादन एक नई पोस्ट ID बनाता है
edit_history_tweet_ids में सभी संस्करण शामिल होते हैं (सबसे पुराना पहले)
एंडपॉइंट हमेशा सबसे नया संस्करण लौटाता है

उदाहरण रिस्पॉन्स

{
  "data": {
    "id": "1234567893",
    "text": "Hello world! (edited twice)",
    "edit_history_tweet_ids": [
      "1234567890",
      "1234567891",
      "1234567893"
    ]
  }
}

30 मिनट की संपादन विंडो के बाद प्राप्त की गई पोस्ट्स उनके अंतिम संस्करण को दर्शाती हैं। रीयल-टाइम उपयोग के मामलों में, ध्यान रखें कि हाल ही में प्रकाशित पोस्ट्स में अभी भी संपादन किया जा सकता है।

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

सामान्य त्रुटियाँ

Status	Error	Solution
400	अमान्य अनुरोध	पैरामीटर का फ़ॉर्मैट जाँचें
401	अनधिकृत	प्रमाणीकरण क्रेडेंशियल्स की पुष्टि करें
403	निषिद्ध	ऐप की अनुमतियाँ जाँचें
404	नहीं मिला	पोस्ट हटा दी गई है या मौजूद नहीं है
429	बहुत अधिक अनुरोध	कुछ देर प्रतीक्षा करें और फिर से प्रयास करें (रेट लिमिट्स देखें)

हटाई गई या संरक्षित पोस्ट्स

यदि कोई पोस्ट हटा दी गई है या किसी ऐसे संरक्षित खाते से है जिसे आप फ़ॉलो नहीं करते हैं:

एकल पोस्ट लुकअप 404 लौटाता है
मल्टी-पोस्ट लुकअप परिणामों में उस पोस्ट को शामिल नहीं करता और errors array देता है

{
  "data": [
    { "id": "1234567890", "text": "Available post" }
  ],
  "errors": [
    {
      "resource_id": "1234567891",
      "resource_type": "tweet",
      "title": "Not Found Error",
      "detail": "Could not find tweet with id: [1234567891]."
    }
  ]
}

सर्वोत्तम प्रथाएँ

बैच अनुरोध

API कॉल कम करने के लिए एक साथ अधिकतम 100 पोस्ट्स प्राप्त करने हेतु multi-Post एंडपॉइंट का उपयोग करें।

केवल आवश्यक फ़ील्ड्स का अनुरोध करें

रिस्पॉन्स का आकार और प्रोसेसिंग समय कम करने के लिए केवल वही फ़ील्ड्स निर्दिष्ट करें जिनकी आपको आवश्यकता है।

रिस्पॉन्स कैश करें

एक ही सामग्री के लिए बार-बार किए जाने वाले अनुरोधों को कम करने हेतु पोस्ट डेटा को स्थानीय रूप से कैश करें।

संपादनों का ध्यान रखें

रीयल-टाइम ऐप्स के लिए, 30 मिनट की एडिट विंडो के बाद पोस्ट्स को फिर से फ़ेच करने पर विचार करें।

अगले चरण

API संदर्भ

एंडपॉइंट का संपूर्ण दस्तावेज़

डेटा शब्दकोश

सभी उपलब्ध ऑब्जेक्ट और फ़ील्ड्स

नमूना कोड

काम करने वाले कोड उदाहरण

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

त्रुटियों को प्रभावी ढंग से संभालें