v1 से v2

सूचियों का प्रबंधन: मानक v1.1 की X API v2 से तुलना

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

समानताएँ
- प्रमाणीकरण
अंतर
- एंडपॉइंट URL
- ऐप और प्रोजेक्ट की आवश्यकताएँ
- HTTP मेथड
- रेट लिमिट्स
- अनुरोध पैरामीटर

समानताएँ

प्रमाणीकरण दोनों endpoint संस्करण OAuth 1.0a User Context का समर्थन करते हैं। इसलिए, यदि आप पहले standard v1.1 के सूची-प्रबंधन endpoints में से किसी एक का उपयोग कर रहे थे, तो X API v2 संस्करण पर माइग्रेट करने के बाद भी आप उसी प्रमाणीकरण विधि का उपयोग जारी रख सकते हैं।

अंतर

एंडपॉइंट URL

मानक v1.1 एंडपॉइंट:
- POST https://api.x.com/1.1/lists/create.json (एक सूची बनाता है)
- POST https://api.x.com/1.1/lists/destroy.json (एक सूची हटाता है)
- POST https://api.x.com/1.1/lists/update.json (एक सूची अपडेट करता है)
X API v2 एंडपॉइंट:
- POST https://api.x.com/2/lists (एक सूची बनाता है)
- DELETE https://api.x.com/2/lists/:id (एक सूची हटाता है)
- PUT https://api.x.com/2/lists/:id (एक सूची अपडेट करता है)

रेट लिमिट्स

मानक v1.1	X API v2
/1.1/lists/create.json कोई नहीं	/2/lists OAuth 1.0a User Context के साथ 15 मिनट की विंडो में 300 अनुरोध
/1.1/lists/destroy.json कोई नहीं	/2/lists/:id OAuth 1.0a User Context के साथ 15 मिनट की विंडो में 300 अनुरोध
/1.1/lists/update.json कोई नहीं	/2/lists/:id OAuth 1.0a User Context के साथ 15 मिनट की विंडो में 300 अनुरोध

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

मानक	X API v2
name	name
mode	private
description	description

किसी सूची को हटाना/अपडेट करना

मानक	X API v2
owner_screen_name	कोई समकक्ष नहीं
owner_id	कोई समकक्ष नहीं
list_id	id
slug	कोई समकक्ष नहीं

कृपया ध्यान दें: मानक v1.1 पैरामीटर क्वेरी पैरामीटर के रूप में पास किए जाते हैं, जबकि X API v2 पैरामीटर बॉडी पैरामीटर (POST एंडपॉइंट के लिए) या पाथ पैरामीटर (DELETE और PUT एंडपॉइंट्स के लिए) के रूप में पास किए जाते हैं।

कोड उदाहरण

एक सूची बनाएँ (v2)

cURL

curl -X POST "https://api.x.com/2/lists" \
  -H "Authorization: OAuth ..." \
  -H "Content-Type: application/json" \
  -d '{"name": "My List", "description": "A great list"}'

# OAuth 1.0a User Context प्रमाणीकरण आवश्यक है
import requests
from requests_oauthlib import OAuth1

auth = OAuth1(
    "API_KEY", "API_SECRET",
    "ACCESS_TOKEN", "ACCESS_TOKEN_SECRET"
)

url = "https://api.x.com/2/lists"
data = {"name": "My List", "description": "A great list"}

response = requests.post(url, auth=auth, json=data)
print(response.json())

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.lists.create(name="My List", description="A great list")
print(f"Created List: {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.lists.create({
  name: "My List",
  description: "A great list",
});
console.log(`Created List: ${response.data?.id}`);

किसी सूची को हटाएँ (v2)

cURL

curl -X DELETE "https://api.x.com/2/lists/123456789" \
  -H "Authorization: OAuth ..."

# OAuth 1.0a User Context प्रमाणीकरण आवश्यक है
import requests
from requests_oauthlib import OAuth1

auth = OAuth1(
    "API_KEY", "API_SECRET",
    "ACCESS_TOKEN", "ACCESS_TOKEN_SECRET"
)

url = "https://api.x.com/2/lists/123456789"
response = requests.delete(url, auth=auth)
print(response.json())

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.lists.delete("123456789")
print(f"Deleted: {response.data.deleted}")

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.lists.delete("123456789");
console.log(`Deleted: ${response.data?.deleted}`);

Getting Started

Fundamentals

Partners & Customers

Resources

v1 से v2

सूचियों का प्रबंधन: मानक v1.1 की X API v2 से तुलना

समानताएँ

अंतर

कोड उदाहरण

एक सूची बनाएँ (v2)

किसी सूची को हटाएँ (v2)

​सूचियों का प्रबंधन: मानक v1.1 की X API v2 से तुलना

​समानताएँ

​अंतर

​कोड उदाहरण

​एक सूची बनाएँ (v2)

​किसी सूची को हटाएँ (v2)

सूचियों का प्रबंधन: मानक v1.1 की X API v2 से तुलना

समानताएँ

अंतर

कोड उदाहरण

एक सूची बनाएँ (v2)

किसी सूची को हटाएँ (v2)