v1 से v2

Standard v1.1 की X API v2 से तुलना

यदि आप standard v1.1 के POST statuses/update और POST statuses/destroy/:id एंडपॉइंट के साथ काम कर रहे हैं, तो इस गाइड का उद्देश्य standard और X API v2 के पोस्ट्स प्रबंधन एंडपॉइंट के बीच समानताओं और अंतरों को समझने में आपकी मदद करना है।

समानताएँ
- प्रमाणीकरण
अंतर
- Endpoint URLs
- ऐप और प्रोजेक्ट आवश्यकताएँ
- अनुरोध पैरामीटर

समानताएँ

प्रमाणीकरण मानक v1.1 और X API v2, दोनों में पोस्ट्स को प्रबंधित करने वाले एंडपॉइंट्स (POST statuses/update और POST statuses/destroy/:id) OAuth 1.0a User Context का उपयोग करते हैं। इसलिए, यदि आप पहले मानक v1.1 के किसी एंडपॉइंट का उपयोग कर रहे थे, तो X API v2 संस्करण पर माइग्रेट करने के बाद भी आप उसी प्रमाणीकरण विधि का उपयोग जारी रख सकते हैं।

अंतर

एंडपॉइंट URL

Standard v1.1 एंडपॉइंट:
- https://api.x.com/1.1/statuses/update.json (एक पोस्ट बनाता है)
- https://api.x.com/1.1/statuses/destroy/:id.json (एक पोस्ट हटाता है)
X API v2 एंडपॉइंट:
- https://api.x.com/2/tweets (एक पोस्ट बनाता है)
- https://api.x.com/2/tweets/:id (निर्दिष्ट पोस्ट को हटाता है)

ऐप और प्रोजेक्ट संबंधी आवश्यकताएँ

X API v2 एंडपॉइंट्स के लिए यह आवश्यक है कि आप अपने अनुरोधों को प्रमाणित करते समय ऐसे डेवलपर ऐप के क्रेडेंशियल्स का उपयोग करें, जो किसी प्रोजेक्ट से संबद्ध हो। सभी X API v1.1 एंडपॉइंट्स ऐप्स या किसी प्रोजेक्ट से संबद्ध ऐप्स के क्रेडेंशियल्स का उपयोग कर सकते हैं।

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

निम्नलिखित मानक v1.1 अनुरोध पैरामीटर दो क्वेरी पैरामीटर (user_id या screen_name) स्वीकार करते थे। X API v2, DELETE एंडपॉइंट के लिए केवल संख्यात्मक पोस्ट ID स्वीकार करता है, और इसे एंडपॉइंट पाथ के हिस्से के रूप में पास किया जाना चाहिए। POST एंडपॉइंट के लिए, अतिरिक्त पैरामीटर अनुरोध की JSON बॉडी में पास करने होंगे। कौन-से पैरामीटर उपलब्ध हैं, इसके बारे में आप API संदर्भ गाइड में अधिक जान सकते हैं।

कोड उदाहरण

पोस्ट बनाएँ (v2)

cURL

curl -X POST "https://api.x.com/2/tweets" \
  -H "Authorization: OAuth ..." \
  -H "Content-Type: application/json" \
  -d '{"text": "Hello world!"}'

from xdk import Client
from xdk.oauth1_auth import OAuth1

oauth1 = OAuth1(
    api_key="YOUR_API_KEY",
    api_secret="YOUR_API_SECRET",
    access_token="YOUR_ACCESS_TOKEN",
    access_token_secret="YOUR_ACCESS_TOKEN_SECRET"
)

client = Client(auth=oauth1)

# पोस्ट बनाएँ
response = client.posts.create(text="Hello world!")
print(f"Created Post: {response.data.id}")

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

const oauth1 = new OAuth1({
  apiKey: "YOUR_API_KEY",
  apiSecret: "YOUR_API_SECRET",
  accessToken: "YOUR_ACCESS_TOKEN",
  accessTokenSecret: "YOUR_ACCESS_TOKEN_SECRET",
});

const client = new Client({ oauth1 });

// पोस्ट बनाएँ
const response = await client.posts.create({ text: "Hello world!" });
console.log(`Created Post: ${response.data?.id}`);

पोस्ट हटाएँ (v2)