Administrar cuentas silenciadas

Administrar silenciamientos: standard v1.1 en comparación con X API v2

Si has estado trabajando con los endpoints estándar v1.1 POST mutes/users/create y POST mutes/users/destroy, el objetivo de esta guía es ayudarte a comprender las similitudes y diferencias entre los endpoints para administrar silenciamientos de standard v1.1 y X API v2.

Similitudes
- Contexto de usuario OAuth 1.0a
Diferencias
- URL de endpoints
- Requisitos de App y Project
- Métodos HTTP
- Parámetros de solicitud

Similitudes

Método de autenticación OAuth 1.0a User Context Ambas versiones del endpoint admiten OAuth 1.0a User Context. Por lo tanto, si antes utilizabas uno de los endpoints estándar de v1.1 para gestionar silenciamientos, puedes seguir usando el mismo método de autenticación si migras a la versión de X API v2.

Diferencias

URLs de endpoints

Endpoints estándar v1.1:
- POST https://api.x.com/1.1/mutes/users/create.json (silenciar a un usuario)
- POST https://api.x.com/1.1/mutes/users/destroy.json (dejar de silenciar a un usuario)
Endpoint de X API v2:
- POST https://api.x.com/2/users/:id/muting (silenciar a un usuario)
- DELETE https://api.x.com/2/users/:source_user_id/muting/:target_user_id (dejar de silenciar a un usuario)

Requisitos de App y Project Los endpoints de X API v2 requieren que uses credenciales de una developer App que esté asociada con un Project al autenticar tus solicitudes. Todos los endpoints de X API v1.1 pueden usar credenciales de Apps o de Apps asociadas con un Project. Parámetros de solicitud Los siguientes parámetros de solicitud estándar v1.1 tienen equivalentes en X API v2:

Estándar v1.1	X API v2
user_id	target_user_id
screen_name	Sin equivalente

Ten en cuenta que los parámetros estándar v1.1 se envían como parámetros de consulta, mientras que los parámetros de X API v2 se envían como parámetros en el cuerpo (para el endpoint POST) o parámetros de ruta (para el endpoint DELETE). Además, no se requiere el id del usuario que silencia a un usuario de destino cuando se usan los endpoints estándar v1.1, ya que los tokens de acceso enviados con OAuth 1.0a User Context permitían inferir qué usuario estaba iniciando la acción de silenciar/dejar de silenciar.

Ejemplos de código

Silenciar a un usuario (v2)

cURL

curl -X POST "https://api.x.com/2/users/123456789/muting" \
  -H "Authorization: OAuth ..." \
  -H "Content-Type: application/json" \
  -d '{"target_user_id": "2244994945"}'

# Requiere autenticación OAuth 1.0a con contexto de usuario (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/users/123456789/muting"
response = requests.post(url, auth=auth, json={"target_user_id": "2244994945"})
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)

# Silenciar a un usuario
response = client.users.mute(
    source_user_id="123456789",
    target_user_id="2244994945"
)
print(f"Muting: {response.data.muting}")

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 });

// Silenciar a un usuario
const response = await client.users.mute("123456789", {
  targetUserId: "2244994945",
});
console.log(`Muting: ${response.data?.muting}`);

Dejar de silenciar a un usuario (v2)

cURL

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

# Requiere autenticación OAuth 1.0a en contexto de usuario
import requests
from requests_oauthlib import OAuth1

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

url = "https://api.x.com/2/users/123456789/muting/2244994945"
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)

# Dejar de silenciar a un usuario
response = client.users.unmute(
    source_user_id="123456789",
    target_user_id="2244994945"
)
print(f"Muting: {response.data.muting}")

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 });

// Dejar de silenciar a un usuario
const response = await client.users.unmute("123456789", "2244994945");
console.log(`Muting: ${response.data?.muting}`);

Getting Started

Fundamentals

Partners & Customers

Resources

Administrar cuentas silenciadas

Administrar silenciamientos: standard v1.1 en comparación con X API v2

Similitudes

Diferencias

Ejemplos de código

Silenciar a un usuario (v2)

Dejar de silenciar a un usuario (v2)

​Administrar silenciamientos: standard v1.1 en comparación con X API v2

​Similitudes

​Diferencias

​Ejemplos de código

​Silenciar a un usuario (v2)

​Dejar de silenciar a un usuario (v2)

Administrar silenciamientos: standard v1.1 en comparación con X API v2

Similitudes

Diferencias

Ejemplos de código

Silenciar a un usuario (v2)

Dejar de silenciar a un usuario (v2)