- Herramientas útiles
- Conceptos clave
- Autenticación
- Portal de desarrolladores, Proyectos y Apps
- Límites de uso
- Etiquetas de origen
- Configuración del perfil
- Añadir contenido multimedia a un Post
Guías
Guía de integración
Esta página contiene información sobre varias herramientas y conceptos clave que debes conocer al integrar los endpoints de gestión de Posts en tu sistema. Hemos dividido la página en un par de secciones:
Antes de adentrarnos en algunos conceptos clave que le ayudarán a integrar este endpoint, le recomendamos que se familiarice con:
Postman es una excelente herramienta que puedes usar para probar un endpoint. Cada solicitud de Postman incluye todos los parámetros de ruta y de cuerpo para ayudarte a comprender rápidamente qué tienes disponible. Para obtener más información sobre nuestras colecciones de Postman, visita nuestra página “Uso de Postman”.
¿Te interesa configurar este endpoint con código en tu lenguaje de programación preferido? Tenemos varios ejemplos de código disponibles que puedes usar como punto de partida en nuestra página de GitHub.
Aprovecha las bibliotecas de terceros creadas por nuestra comunidad para empezar. Puedes encontrar una biblioteca compatible con los endpoints de la v2 buscando la etiqueta de versión correspondiente.
Todos los endpoints de X API v2 requieren que autentiques tus solicitudes con un conjunto de credenciales, también conocidas como claves y tokens.
Estos endpoints específicos requieren el uso de Contexto de usuario de OAuth 1.0a, lo que significa que debes usar un conjunto de claves de API y tokens de acceso de usuario para realizar una solicitud correcta. Los tokens de acceso deben estar asociados con el usuario en cuyo nombre realizas la solicitud. Si deseas generar un conjunto de tokens de acceso para otro usuario, ese usuario debe autorizar o autenticar tu App utilizando el flujo OAuth en 3 pasos.
Ten en cuenta que OAuth 1.0a puede ser difícil de usar. Si no estás familiarizado con este método de Autenticación, te recomendamos usar una biblioteca, una herramienta como Postman o usar OAuth 2.0 para autenticar tus solicitudes.
Código de autorización de OAuth 2.0 con PKCE permite un mayor control sobre el alcance de una aplicación y flujos de autorización entre múltiples dispositivos. OAuth 2.0 te permite elegir ámbitos específicos y granulares que te otorgan permisos concretos en nombre de un usuario.
Para habilitar OAuth 2.0 en tu App, debes activarlo en la configuración de autenticación de tu App, ubicada en la sección de configuración del Portal de desarrolladores.
Para obtener un conjunto de credenciales de Autenticación que funcione con los endpoints de X API v2, debes tener una cuenta de desarrollador, configurar un Proyecto dentro de esa cuenta y crear una App de desarrollador dentro de ese Proyecto. Luego podrás encontrar tus claves y tokens en tu App de desarrollador.
Cada día, miles de desarrolladores realizan solicitudes a la X API. Para ayudar a gestionar el alto volumen de estas solicitudes, se aplican límites de uso a cada endpoint que restringen la cantidad de solicitudes que puedes realizar en nombre de tu App o de un usuario autenticado.
Estos endpoints tienen límites a nivel de usuario, lo que significa que el usuario autenticado en cuyo nombre haces la solicitud solo puede invocar el endpoint un número determinado de veces en cualquier App de desarrollador. Existe un límite de 200 solicitudes por 15 minutos para el método POST. El método DELETE tiene un límite de 50 solicitudes por 15 minutos. Además, existe un límite de 300 solicitudes por 3 horas, incluidos los Posts creados con manage Posts o manage Retweets.
El nombre de tu App y la URL de tu sitio web se mostrarán como etiqueta de origen dentro de los metadatos de cualquier Post creado de forma programática por tu aplicación. Si cambias el caso de uso de una App de X, asegúrate de actualizarlo en estos ajustes para cumplir con los Términos para Desarrolladores.
Solo puedes añadir una ubicación a los Posts si tienes la geolocalización habilitada en la configuración de tu perfil. Si no tienes la geolocalización habilitada, aún puedes añadir un parámetro de ubicación en el cuerpo de la solicitud, pero no se adjuntará a tu Post. Lo mismo aplica al etiquetar usuarios en imágenes. Si el usuario al que etiquetas no tiene habilitado el etiquetado de fotos, su nombre no aparecerá en la lista de usuarios etiquetados, aunque el Post se cree correctamente.
Actualmente no existe una forma de cargar contenido multimedia de principio a fin usando la v2 de la X API. Sin embargo, puedes adjuntar a un Post contenido multimedia que ya hayas cargado previamente. Puedes usar ids de medios que ya se hayan cargado con el endpoint de medios de v1 o con X Media Studio. Estos ids de medios deben ser tuyos o de un usuario autenticado.
Próximos pasos
Referencia de la API