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

shellscript

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

Dejar de silenciar a un usuario (v2)

cURL

shellscript

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