v1 a v2

Administrar Listas: Standard v1.1 en comparación con X API v2

Si has estado trabajando con los endpoints standard v1.1 POST lists/create, POST lists/destroy y POST lists/update, el objetivo de esta guía es ayudarte a comprender las similitudes y diferencias entre los endpoints para administrar Listas en standard v1.1 y en X API v2.

• Similitudes
  • Autenticación
• Diferencias
  • URLs de los endpoints
  • Requisitos de App y de Proyecto
  • Métodos HTTP
  • Límites de tasa
  • Parámetros de la solicitud

Similitudes

Autenticación

Ambas versiones del endpoint admiten OAuth 1.0a User Context. Por lo tanto, si anteriormente utilizabas uno de los endpoints estándar de v1.1 para administrar Listas, 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/lists/create.json (Crea una Lista)
  • POST https://api.x.com/1.1/lists/destroy.json (Elimina una Lista)
  • POST https://api.x.com/1.1/lists/update.json (Actualiza una Lista)
• Endpoint de X API v2:

  • POST https://api.x.com/2/lists (Crea una Lista)

  • DELETE https://api.x.com/2/lists/:id (Elimina una Lista)

  • PUT https://api.x.com/2/lists/:id (Actualiza una Lista)

Límites de tasa

Estándar v1.1	X API v2
/1.1/lists/create.json ninguno	/2/lists 300 solicitudes por ventana de 15 minutos con contexto de usuario OAuth 1.0a
/1.1/lists/destroy.json ninguno	/2/lists/:id 300 solicitudes por ventana de 15 minutos con contexto de usuario OAuth 1.0a
/1.1/lists/update.json ninguno	/2/lists/:id 300 solicitudes por ventana de 15 minutos con contexto de usuario OAuth 1.0a

Requisitos de App y Proyecto

Los endpoints de X API v2 requieren que utilices credenciales de una App de desarrollador asociada a un Proyecto al autenticar tus solicitudes. Todos los endpoints de X API v1.1 pueden usar credenciales de Apps independientes o de Apps relacionadas con un proyecto.

Parámetros de la solicitud

Los siguientes parámetros de solicitud estándar v1.1 tienen equivalentes en X API v2:

Crear una Lista

Estándar	X API v2
name	name
mode	private
description	description

Eliminar/Actualizar una Lista

Estándar	X API v2
owner_screen_name	Sin equivalente
owner_id	Sin equivalente
list_id	id
slug	Sin equivalente

Ten en cuenta: Los parámetros estándar v1.1 se pasan como parámetros de consulta, mientras que los parámetros de X API v2 se pasan como parámetros en el cuerpo (para el endpoint POST) o parámetros de ruta (para los endpoints DELETE y PUT).

---

Ejemplos de código

Crear una Lista (v2)

cURL

shellscript

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"}'

Eliminar una Lista (v2)

cURL

shellscript

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