Skip to main content
La X API v2 está diseñada con patrones consistentes en todos los endpoints. Una vez que aprendas cómo funciona un endpoint, los mismos patrones se aplican en todos.

Patrones consistentes

Estructura de URL

Todos los endpoints v2 siguen un patrón predecible:
Ejemplos:

Estructura de respuesta

Todas las respuestas usan la misma estructura de nivel superior:

Formato de ID

Todos los IDs se devuelven como cadenas para asegurar compatibilidad entre lenguajes:

Campos y expansiones

Los mismos parámetros de fields y expansions funcionan de forma consistente:

Esquemas de objetos

El mismo tipo de objeto tiene los mismos campos independientemente del endpoint que lo devuelva:
  • Un Post desde search tiene los mismos campos que un Post desde lookup
  • Un User desde followers tiene los mismos campos que un User desde search
  • Los objetos expandidos coinciden con sus contrapartes autónomas

Autenticación

Todos los endpoints usan los mismos métodos de autenticación:

Gestión de errores

Los errores siguen un formato consistente:
Ver todos los tipos de errores →

Paginación

Todos los endpoints paginados usan el mismo sistema de tokens: Aprende más sobre paginación →

Convenciones de nomenclatura

  • Ortografía en inglés estadounidense (favorites en lugar de favourites)
  • Snake_case para nombres de campos (author_id, created_at)
  • Terminología consistente (retweet_count, no repost_count en los campos)

Valores vacíos

Los campos sin valor se omiten en lugar de devolverse como null:

Consistencia de entidades

El objeto entities solo contiene entidades parseadas desde el texto:
  • urls
  • hashtags
  • mentions
  • cashtags
Los medios y las encuestas están en attachments, no en entities.

Qué significa esto para ti

Aprende una vez, úsalo en todas partes

Los patrones que aprendes en un endpoint se aplican a todos los endpoints.

Respuestas predecibles

Los mismos tipos de objetos tienen las mismas estructuras en toda la API.

Código más simple

Crea funciones reutilizables para patrones comunes.

Depuración más sencilla

Formatos de error consistentes simplifican la solución de problemas.

Reportar inconsistencias

¿Encontraste una inconsistencia? Cuéntanos: