Gestionar silencios

Gestionar silenciamientos: estándar v1.1 frente a X API v2

Si ha 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 ayudarle a comprender las similitudes y diferencias entre los endpoints para gestionar silenciamientos del estándar v1.1 y de X API v2.

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

Similitudes

Método de autenticación Contexto de usuario de OAuth 1.0a

Ambas versiones del endpoint admiten Contexto de usuario de OAuth 1.0a. Por lo tanto, si antes usabas 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 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 (quitar el silencio 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 (quitar el silencio a un usuario)

Requisitos de App y Project

Los endpoints de X API v2 requieren que uses credenciales de una developer App asociada a un Project al autenticar tus solicitudes. Todos los endpoints de X API v1.1 pueden usar credenciales de Apps autónomas o Apps asociadas a 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 de la versión 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 Contexto de usuario de OAuth 1.0a permitían inferir qué usuario estaba iniciando la acción de silenciar o quitar el silencio.