- Herramientas útiles
- Conceptos clave
- Autenticación
- Portal de desarrolladores, Projects y Apps
- Límites de tasa
- Etiquetas de origen
- Configuración del perfil
- Agregar 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 Posts de manag en tu sistema. Hemos dividido la página en un par de secciones:
Antes de entrar en algunos conceptos clave que le ayudarán a integrar este endpoint, le recomendamos familiarizarse con:
Postman es una excelente herramienta 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 “Using Postman”.
¿Desea configurar este endpoint con código en su lenguaje de programación preferido? Contamos con varios ejemplos de código que puede usar como punto de partida en nuestra página de GitHub.
Aproveche alguna de las bibliotecas de terceros de nuestras comunidades para empezar. Puede encontrar una biblioteca compatible con los endpoints de 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 keys and 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 API Key y Access Tokens de usuario para realizar una solicitud correctamente. Los Access Tokens deben estar asociados con el usuario en cuyo nombre realizas la solicitud. Si deseas generar un conjunto de Access Tokens para otro usuario, ese usuario debe autorizar o autenticar tu App mediante el flujo de OAuth de 3 fases.
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 library, utilizar una herramienta como Postman o usar OAuth 2.0 para autenticar tus solicitudes.
OAuth 2.0 Authorization Code with PKCE permite un mayor control sobre el alcance de una aplicación y sobre los flujos de autorización en múltiples dispositivos. OAuth 2.0 te permite elegir permisos específicos y granulares (scopes) que te otorgan facultades concretas 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 funcionen con los endpoints de la X API v2, debes tener una cuenta de desarrollador, configurar un Project dentro de esa cuenta y haber creado una App de desarrollador dentro de ese Project. Luego podrás encontrar tus keys and tokens dentro de tu App de desarrollador.
Cada día, muchos miles de desarrolladores realizan solicitudes a la X API. Para ayudar a gestionar el gran volumen de estas solicitudes, se aplican límites de tasa a cada endpoint que limitan la cantidad de solicitudes que puedes realizar en nombre de tu App o en nombre de un usuario autenticado.
Estos endpoints tienen límites de tasa a nivel de usuario, lo que significa que el usuario autenticado en cuyo nombre realizas la solicitud solo puede invocar el endpoint un número determinado de veces desde cualquier App de desarrollador. Existe un límite de tasa de usuario de 200 solicitudes por 15 minutos para el método POST. El método DELETE tiene un límite de tasa 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 X App, asegúrate de actualizarlo en esta configuración para garantizar el cumplimiento de 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 la tienes habilitada, aún puedes incluir un parámetro de ubicación en el cuerpo de la solicitud, pero no se adjuntará a tu Post. Lo mismo aplica para 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 hay una forma de cargar multimedia por completo usando v2 de la X API. Sin embargo, puedes adjuntar a un Post multimedia que ya haya sido cargada previamente. Puedes usar id de multimedia que ya hayan sido cargados usando el endpoint de multimedia de v1 o X Media Studio. Estos id de multimedia deben ser tuyos o de un usuario autenticado.
Próximos pasos
Referencia de la API
⌘I