परिचय

DM ब्लॉक प्रबंधित करने वाले एंडपॉइंट्स आपको किसी प्रमाणीकृत उपयोगकर्ता की ओर से किसी निर्दिष्ट खाते को ब्लॉक या अनब्लॉक करने की सुविधा देते हैं। इन एंडपॉइंट्स के लिए, दो POST methods उपलब्ध हैं:

• /2/users/:id/dm/block: आपको किसी खाते को ब्लॉक करने की अनुमति देता है
• /2/users/:id/dm/unblock: आपको किसी खाते को अनब्लॉक करने की अनुमति देता है

शुरुआत करें

प्रमाणीकरण

चूँकि आप किसी उपयोगकर्ता की ओर से अनुरोध कर रहे हैं, इसलिए आपको इन एंडपॉइंट्स को OAuth 1.0a User Context या OAuth 2.0 Authorization Code with PKCE में से किसी एक का उपयोग करके प्रमाणित करना होगा, और उस उपयोगकर्ता से संबद्ध user Access Tokens का उपयोग करना होगा जिसकी ओर से आप अनुरोध कर रहे हैं। आप यह user Access Token 3-legged OAuth flow (OAuth 1.0a) या Authorization Code with PKCE grant flow (OAuth 2.0) का उपयोग करके जनरेट कर सकते हैं।

अनुरोध भेजना

Block

जब कोई उपयोगकर्ता आपके ऐप के साथ प्रमाणित हो जाता है, तो आप नीचे दिखाए गए अनुसार उपयोगकर्ता की ओर से Block एंडपॉइंट को कॉल कर सकते हैं:

      curl --request POST 'https://api.x.com/2/users/:id/dm/block' --header 'Authorization: ••••••'

यदि अनुरोध सफल होता है, तो आपको नीचे दिखाए गए अनुसार JSON रिस्पॉन्स दिखाई देना चाहिए:

{
   "data": {
       "blocked": true
   }
}

अनब्लॉक

जब कोई उपयोगकर्ता आपके ऐप के साथ प्रमाणित हो जाता है, तो आप नीचे दिखाए गए अनुसार उस उपयोगकर्ता की ओर से Unblock एंडपॉइंट को कॉल कर सकते हैं:

      curl --request POST 'https://api.x.com/2/users/:id/dm/unblock' --header 'Authorization: ••••••'

यदि अनुरोध सफल होता है, तो आपको नीचे दिखाए गए अनुसार JSON रिस्पॉन्स दिखाई देगा:

{
   "data": {
       "blocked": false
   }
}