v1 से v2

Standard v1.1 टाइमलाइन्स से X API v2 टाइमलाइन्स

यदि आप v1.1 timelines endpoints (statuses/user_timeline और statuses/mentions_timeline) के साथ काम कर रहे हैं, तो इस गाइड का उद्देश्य आपको standard और X API v2 timelines endpoints के बीच समानताओं और अंतरों को समझने में मदद करना है, ताकि आप अपने मौजूदा integration को नए संस्करण में migrate कर सकें।

समानताएँ:
- प्रमाणीकरण:
  - OAuth 1.0a User Context (रिवर्स क्रोनोलॉजिकल होम टाइमलाइन, उपयोगकर्ता पोस्ट टाइमलाइन और उपयोगकर्ता mentions टाइमलाइन)
  - OAuth 2.0 App-Only (उपयोगकर्ता पोस्ट टाइमलाइन)
- Historical Access limit: User timeline (उपयोगकर्ता पोस्ट टाइमलाइन) सबसे हाल की 3200 पोस्ट्स तक पहुँच प्रदान करती है; mentions timeline (उपयोगकर्ता mention टाइमलाइन) सबसे हाल के 800 mentions तक पहुँच प्रदान करती है।
- पोस्ट edit history और metadata के लिए समर्थन
- रेट लिमिट्स (उपयोगकर्ता पोस्ट टाइमलाइन)
- Refresh polling: since_id के बाद से नए results प्राप्त करने की क्षमता
- पोस्ट IDs के माध्यम से टाइमलाइन्स में traverse करने की क्षमता
- Results specifications:
  - Results order: लौटाए गए results रिवर्स क्रोनोलॉजिकल क्रम में होते हैं
  - replies को exclude करने की क्षमता (केवल उपयोगकर्ता पोस्ट टाइमलाइन)
  - Retweets को exclude करने की क्षमता (केवल उपयोगकर्ता पोस्ट टाइमलाइन)
अंतर
- नई प्रमाणीकरण क्षमता:
  - OAuth 2.0 App-Only (उपयोगकर्ता mention टाइमलाइन)
  - OAuth 2.0 Authorization Code Flow with PKCE (रिवर्स क्रोनोलॉजिकल होम टाइमलाइन, उपयोगकर्ता पोस्ट टाइमलाइन और उपयोगकर्ता mentions टाइमलाइन)
- पहुँच संबंधी आवश्यकताएँ: X API v2 ऐप और Project आवश्यकताएँ
- रेट लिमिट्स (उपयोगकर्ता mention टाइमलाइन और रिवर्स क्रोनोलॉजिकल होम टाइमलाइन)
- अतिरिक्त pagination method
  - प्रति रिस्पॉन्स अलग max_results (count)
- प्रतिक्रिया डेटा प्रारूप
- अनुरोध पैरामीटर
  - अनुरोध पैरामीटर के आधार पर अनुकूलित डेटा प्रारूप, जिसमें v2 फ़ील्ड्स और expansions शामिल हैं
  - अतिरिक्त उपलब्ध डेटा: metrics, पोस्ट annotations, polls

समानताएँ

प्रमाणीकरण v1.1 statuses/user_timeline और X API v2 उपयोगकर्ता पोस्ट टाइमलाइन endpoint, दोनों OAuth 1.0a User Context और OAuth 2.0 App-Only का समर्थन करते हैं। इसलिए, यदि आप X API v2 संस्करण पर माइग्रेट करते हैं, तो आप उसी प्रमाणीकरण विधि और प्राधिकरण टोकन का उपयोग जारी रख सकते हैं। ऐतिहासिक ऐक्सेस v1.1 statuses/user_timeline और X API v2 उपयोगकर्ता पोस्ट टाइमलाइन endpoint, दोनों Retweets सहित सबसे हाल के 3200 पोस्ट्स लौटाते हैं। v1.1 statuses/mentions_timeline और X API v2 user mention timeline endpoint, दोनों सबसे हाल के 800 पोस्ट्स लौटा सकते हैं। पोस्ट edit history और metadata के लिए समर्थन दोनों संस्करण ऐसा metadata प्रदान करते हैं जो किसी भी edit history का वर्णन करता है। अधिक जानकारी के लिए filtered stream API संदर्भ और Edit Posts fundamentals page देखें। रेट लिमिट्स


Standard v1.1	X API v2
user_timeline: OAuth 1.0a User Context के साथ 15 मिनट में 900 अनुरोध OAuth 2.0 App-Only के साथ 15 मिनट में 1500 अनुरोध	User Posts timeline: OAuth 1.0a User Context के साथ 15-मिनट की विंडो में 900 अनुरोध OAuth 2.0 App-Only के साथ 15-मिनट की विंडो में 1500 अनुरोध

since_id का उपयोग करके रिफ्रेश polling दोनों संस्करण since_id का उपयोग करके हाल के results के लिए polling की अनुमति देते हैं। पोस्ट IDs का उपयोग करके timelines को traverse करना दोनों endpoints में पोस्ट ID ‘timestamps’ का उपयोग करके timelines को traverse करने की क्षमता है, जो पोस्ट IDs के बनाए जाने के तरीके पर आधारित है। कार्यक्षमता आम तौर पर समान है, केवल निम्नलिखित अंतर हैं:


Standard timelines v1.1	timelines v2
since_id (exclusive) max_id (inclusive)	since_id (exclusive) until_id (यह भी exclusive है, जबकि max_id inclusive था)

रिस्पॉन्स फ़िल्टरिंग पैरामीटर


Standard timelines v1.1	timelines v2
रिस्पॉन्स फ़िल्टरिंग पैरामीटर: * include_rts * exclude_replies	रिस्पॉन्स फ़िल्टरिंग पैरामीटर: * exclude=retweets,replies
उदाहरण https://api.x.com/1.1/statuses/user_timeline.json?user_id=2244994945&include_rts=0&&exclude_replies=1	उदाहरण: https://api.x.com/2/users/2244994945/tweets?max_results=100&exclude=retweets,replies
टिप्पणियाँ: For user_timeline: * include_rts=0 का उपयोग करने से सबसे हाल के 3200 पोस्ट्स की संभावित ऐतिहासिक सीमा नहीं बदलती	टिप्पणियाँ: For user Posts timeline: * exclude=retweets का उपयोग करने से सबसे हाल के 3200 पोस्ट्स की संभावित ऐतिहासिक सीमा नहीं बदलती * exclude=replies का उपयोग करने से संभावित ऐतिहासिक पोस्ट सीमा घटकर सबसे हाल की 800 replies तक रह जाती है

अंतर

प्रमाणीकरण **v1.1 statuses/mentions_timeline endpoint केवल OAuth 1.0a User Context का समर्थन करता है। X API v2 user mention timeline endpoint OAuth 1.0a User Context, OAuth 2.0 App-Only, और OAuth 2.0 Authorization Code with PKCE — तीनों का समर्थन करता है। ** यदि आप X API v2 उपयोगकर्ता पोस्ट टाइमलाइन endpoint का उपयोग करके private या promoted metrics तक पहुँचने की सुविधा का लाभ उठाना चाहते हैं, तो आपको OAuth 1.0a User Context या OAuth 2.0 Authorization Code with PKCE का उपयोग करना होगा, और उस उपयोगकर्ता से संबंधित user access tokens पास करने होंगे जिसने वह पोस्ट किया है, जिसके metrics तक आप पहुँचना चाहते हैं। Endpoint URLs ध्यान दें कि X API v2 timelines endpoints में user ID के लिए :id path parameter आवश्यक है।

Standard v1.1 endpoints:
X API v2 endpoint:

ऐप और Project आवश्यकताएँ X API v2 endpoints के लिए यह आवश्यक है कि आप अपने requests को प्रमाणित करते समय ऐसे developer ऐप के credentials का उपयोग करें, जो किसी Project से संबद्ध हो। सभी X API v1.1 endpoints Apps के credentials या किसी project से संबद्ध Apps के credentials का उपयोग कर सकते हैं। रेट लिमिट्स


mentions_timeline: OAuth 1.0a User Context के साथ प्रति 15 मिनट 75 requests	user mention timeline: OAuth 1.0a User Context के साथ प्रति 15-मिनट विंडो 180 requests OAuth 2.0 बेयरर टोकन के साथ प्रति 15-मिनट विंडो 450 requests
home_timelime: प्रति 15 मिनट 15 requests home timeline पर अधिकतम 800 पोस्ट्स प्राप्त की जा सकती हैं	reverse chronological home timeline: प्रति 15 मिनट 180 requests आप timeline पर पिछले 7 दिनों में बनाई गई हर पोस्ट, साथ ही निर्माण तिथि की परवाह किए बिना सबसे हाल की 800 पोस्ट्स भी लौटा सकते हैं।

अनुरोध पैरामीटर


स्टैंडर्ड टाइमलाइन्स v1.1	timelines v2
आवश्यक: user_id या screen_name	आवश्यक: path parameter में विशिष्ट user ID दिया जाता है
वैकल्पिक: count - प्रति अनुरोध लौटाए जाने वाले अधिकतम परिणाम सेट करता है exclude_replies - परिणामों से रिप्लाइ हटाता है Include_rts - 0 पर सेट होने पर परिणामों से retweets हटाता है trim_user - परिणामों से rehydrated user objects हटाता है tweet_mode - परिणामों के लिए लौटाए जाने वाले डेटा फ़ॉर्मैट को सेट करता है; 140 से लंबे पोस्ट्स के लिए इसे extended पर सेट करें since_id - परिणाम में सबसे शुरुआती पोस्ट ID सेट करता है (exclusive) max_id - परिणाम में सबसे नवीनतम पोस्ट ID सेट करता है (inclusive)	वैकल्पिक: max_results - प्रति अनुरोध लौटाए जाने वाले अधिकतम परिणाम सेट करता है exclude=retweets,replies - परिणामों से Retweets या replies हटाता है tweet.fields - लौटाए जाने वाले पोस्ट object फ़ील्ड्स सेट करता है user.fields - लौटाए जाने वाले User object फ़ील्ड्स सेट करता है place.fields - लौटाए जाने वाले place object फ़ील्ड्स सेट करता है media.fields - लौटाए जाने वाले media object फ़ील्ड्स सेट करता है poll.fields - लौटाए जाने वाले poll object फ़ील्ड्स सेट करता है expansions - लौटाए जाने वाले expanded फ़ील्ड्स और डेटा सेट करता है start_time - परिणामों के लिए सबसे शुरुआती created_at समय सेट करता है end_time - परिणामों के लिए सबसे नवीनतम created_at समय सेट करता है since_id - परिणामों के लिए सबसे शुरुआती पोस्ट ID सेट करता है (exclusive) until_id - परिणाम में सबसे नवीनतम पोस्ट ID सेट करता है (exclusive)

प्रतिक्रिया डेटा प्रारूप


स्टैंडर्ड सर्च v1.1	पोस्ट्स खोजें v2
[ tweet object, tweet object ]	“data”: [id,text,id,text], “meta”: “oldest_id”: “1337085692623646724”, “newest_id”: “1334183616172019713”, “previous_token”: “77qpymm88g5h9vqkluldpw91lr0qzfz1sqydh841iz48k”, “result_count”: 10, “next_token”: “7140dibdnow9c7btw3w29gqolns6a1ipl3kzeae41vsxk”

X API v2 JSON फ़ॉर्मैट X API v2, APIs द्वारा लौटाए जाने वाले objects के लिए नए JSON डिज़ाइन पेश कर रहा है, जिनमें पोस्ट और यूज़र objects शामिल हैं। X API v2 फ़ॉर्मैट के बारे में, फ़ील्ड्स और expansions का उपयोग कैसे करें, यह जानने के लिए हमारी guide देखें, और हमारी विस्तृत data dictionary भी पढ़ें

JSON root स्तर पर, standard endpoints statuses array में पोस्ट objects लौटाते हैं, जबकि X API v2 data array लौटाता है।
Retweeted और Quoted “statuses” का संदर्भ देने के बजाय, X API v2 JSON Retweeted और Quoted Tweets का संदर्भ देता है। contributors और user.translator_type जैसे कई legacy और deprecated फ़ील्ड्स हटाए जा रहे हैं।
Post object में favorites और user object में favorites — दोनों का उपयोग करने के बजाय, X API v2 like शब्द का उपयोग करता है।
X इस परंपरा को अपना रहा है कि जिन JSON values का कोई मान नहीं होता (उदाहरण के लिए, null), उन्हें payload में नहीं लिखा जाता। Post और user attributes केवल तभी शामिल किए जाते हैं, जब उनका मान non-null हो।

स्टैंडर्ड v1.1 और X API v2 endpoint versions के बीच सबसे बड़े अंतर में से एक यह है कि आप कैसे चुनते हैं कि आपके payload में कौन-से फ़ील्ड्स लौटें। स्टैंडर्ड endpoints के लिए, payload में कौन-से फ़ील्ड्स या फ़ील्ड्स के समूह लौटेंगे, यह तय करने के लिए कई parameters उपलब्ध थे, जबकि X API v2 version इन अलग-अलग parameters को सरल बनाकर फ़ील्ड्स और expansions में समाहित कर देता है।

fields: X API v2 एंडपॉइंट्स आपको यह चुनने की सुविधा देते हैं कि आपके payload में कौन-से फ़ील्ड्स शामिल किए जाएँ। उदाहरण के लिए, पोस्ट, user, Media, Place, और Poll ऑब्जेक्ट्स में ऐसे फ़ील्ड्स की सूची होती है जिन्हें response में लौटाया जा सकता है (या नहीं)।
expansions: पोस्ट JSON payloads में संदर्भित संबंधित ऑब्जेक्ट्स का विस्तार करने के लिए उपयोग किया जाता है। उदाहरण के लिए, सभी Retweets और Replies अन्य पोस्ट्स को संदर्भित करते हैं। expansions=referenced_tweets.id सेट करने पर, ये अन्य पोस्ट ऑब्जेक्ट्स tweet.fields सेटिंग के अनुसार विस्तारित होकर लौटाए जाते हैं। users, polls, और media जैसे अन्य ऑब्जेक्ट्स का भी विस्तार किया जा सकता है।
conversation_id
context और entities सहित दो नए annotations फ़ील्ड्स
कई नए metrics फ़ील्ड्स

हमने एक data format migration guide तैयार की है, जो standard v1.1 फ़ील्ड्स को नए v2 फ़ील्ड्स से मैप करने में आपकी मदद कर सकती है। यह guide आपको वह विशिष्ट expansion और field parameter भी बताएगी जिन्हें आपको अपनी v2 request के साथ पास करना होगा, ताकि खास फ़ील्ड्स लौटाए जा सकें।

कोड उदाहरण

उपयोगकर्ता की पोस्ट्स टाइमलाइन (v2)

cURL

curl "https://api.x.com/2/users/2244994945/tweets?max_results=100&tweet.fields=created_at,public_metrics&exclude=retweets,replies" \
  -H "Authorization: Bearer $BEARER_TOKEN"

from xdk import Client

client = Client(bearer_token="YOUR_BEARER_TOKEN")

# उपयोगकर्ता की पोस्ट्स टाइमलाइन प्राप्त करें
for page in client.posts.get_user_posts(
    "2244994945",
    tweet_fields=["created_at", "public_metrics"],
    exclude=["retweets", "replies"],
    max_results=100
):
    for post in page.data:
        print(f"{post.created_at}: {post.text[:50]}...")

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

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

// उपयोगकर्ता की पोस्ट्स टाइमलाइन प्राप्त करें
const paginator = client.posts.getUserPosts("2244994945", {
  tweetFields: ["created_at", "public_metrics"],
  exclude: ["retweets", "replies"],
  maxResults: 100,
});

for await (const page of paginator) {
  page.data?.forEach((post) => {
    console.log(`${post.created_at}: ${post.text?.slice(0, 50)}...`);
  });
}

उपयोगकर्ता उल्लेख टाइमलाइन (v2)

cURL

curl "https://api.x.com/2/users/2244994945/mentions?max_results=100&tweet.fields=created_at,author_id" \
  -H "Authorization: Bearer $BEARER_TOKEN"

from xdk import Client

client = Client(bearer_token="YOUR_BEARER_TOKEN")

# उपयोगकर्ता के उल्लेख प्राप्त करें
for page in client.posts.get_user_mentions(
    "2244994945",
    tweet_fields=["created_at", "author_id"],
    max_results=100
):
    for post in page.data:
        print(f"Mentioned by {post.author_id}: {post.text[:50]}...")

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

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

// उपयोगकर्ता के उल्लेख प्राप्त करें
const paginator = client.posts.getUserMentions("2244994945", {
  tweetFields: ["created_at", "author_id"],
  maxResults: 100,
});

for await (const page of paginator) {
  page.data?.forEach((post) => {
    console.log(`Mentioned by ${post.author_id}: ${post.text?.slice(0, 50)}...`);
  });
}

अगले चरण X API v2 पोस्ट lookup की हमारी त्वरित शुरुआत मार्गदर्शिका देखें v2 पोस्ट lookup के लिए API संदर्भ देखें टाइमलाइन endpoints के लिए हमारा sample code देखें

Getting Started

Fundamentals

Partners & Customers

Resources

v1 से v2

Standard v1.1 टाइमलाइन्स से X API v2 टाइमलाइन्स

समानताएँ

अंतर

कोड उदाहरण

उपयोगकर्ता की पोस्ट्स टाइमलाइन (v2)

उपयोगकर्ता उल्लेख टाइमलाइन (v2)

​Standard v1.1 टाइमलाइन्स से X API v2 टाइमलाइन्स

​समानताएँ

​अंतर

​कोड उदाहरण

​उपयोगकर्ता की पोस्ट्स टाइमलाइन (v2)

​उपयोगकर्ता उल्लेख टाइमलाइन (v2)

Standard v1.1 टाइमलाइन्स से X API v2 टाइमलाइन्स

समानताएँ

अंतर

कोड उदाहरण

उपयोगकर्ता की पोस्ट्स टाइमलाइन (v2)

उपयोगकर्ता उल्लेख टाइमलाइन (v2)