Patrones consistentes
Estructura de URL
Todos los endpoints v2 siguen un patrón predecible: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: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 (
favoritesen lugar defavourites) - Snake_case para nombres de campos (
author_id,created_at) - Terminología consistente (
retweet_count, norepost_counten los campos)
Valores vacíos
Los campos sin valor se omiten en lugar de devolverse comonull:
Consistencia de entidades
El objetoentities solo contiene entidades parseadas desde el texto:
urlshashtagsmentionscashtags
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.