Saltar al contenido principal
Esta página contiene información sobre varias herramientas y conceptos clave que debes conocer al integrar los endpoints de Retweet en tu sistema. Hemos dividido la página en varias secciones:

​
Herramientas útiles

Antes de adentrarnos en algunos conceptos clave que le ayudarán a integrar este endpoint, le recomendamos que se familiarice con:

​
Postman

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é está disponible para ti. Para obtener más información sobre nuestras colecciones de Postman, visita nuestra página “Uso de Postman”. 

​
Ejemplos de código

¿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.

​
Bibliotecas de terceros

Aprovecha una de las bibliotecas de terceros de nuestra comunidad para empezar. Puedes encontrar una biblioteca compatible con los endpoints de la versión 2 (v2) buscando la etiqueta de versión correspondiente.  

​
Conceptos clave

​
Autenticación

Todos los endpoints de X API v2 requieren que autentiques tus solicitudes con un conjunto de credenciales, también conocidas como claves y tokens. Puedes usar Contexto de usuario de OAuth 1.0a u OAuth 2.0 Bearer Token para autenticar tus solicitudes al endpoint de búsqueda de Retweets. Los endpoints para gestionar Retweets 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 mediante el flujo OAuth de 3 etapas. Ten en cuenta que OAuth 1.0a puede ser complejo de usar. Si no estás familiarizado con este método de Autenticación, te recomendamos usar una biblioteca para autenticar correctamente tus solicitudes. Ten en cuenta Si solicitas los siguientes fields, se requiere Contexto de usuario de OAuth 1.0a:
  • tweet.fields.non_public_metrics
  • tweet.fields.promoted_metrics
  • tweet.fields.organic_metrics
  • media.fields.non_public_metrics
  • media.fields.promoted_metrics
  • media.fields.organic_metrics

​
Portal de desarrolladores, Proyectos y Apps de desarrollador

Para obtener un conjunto de credenciales de Autenticación que funcionen con los endpoints de X API v2, debes registrarte para obtener 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.   

​
Límites de uso

Cada día, miles de desarrolladores realizan solicitudes a la X API. Para ayudar a gestionar el gran 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. Los endpoints para gestionar Retweets están limitados a 50 solicitudes por cada 15 minutos (por usuario). Además, para el endpoint POST, el límite es de 300 solicitudes por ventana de 3 horas (por usuario y por App). Con el endpoint de consulta de Retweets, el límite es de 75 solicitudes por ventana de 15 minutos. Además, este endpoint solo devolverá a los 100 usuarios más recientes que hayan hecho Retweet.

​
Fields and expansions

X API v2 permite a los usuarios seleccionar exactamente qué datos desean obtener de la API usando un conjunto de herramientas llamadas fields y expansions. El parámetro expansions te permite expandir los objetos referenciados en el payload. Por ejemplo, este endpoint te permite obtener las siguientes expansions:
  • attachments.poll_ids
  • attachments.media_keys
  • author_id, entities.mentions.username
  • geo.place_id
  • in_reply_to_user_id,
  • referenced_tweets.id,
  • referenced_tweets.id.author_id
El parámetro fields te permite seleccionar exactamente qué fields dentro de los diferentes objetos de datos te gustaría recibir. Estos endpoints devuelven principalmente objetos Post. De forma predeterminada, el objeto Post retorna los campos id y text. Para recibir campos adicionales como tweet.created_at o tweet.entities, tendrás que solicitarlos específicamente usando un parámetro fields. Algunos campos importantes que quizá quieras considerar para tu integración son nuestros datos de encuestas, métricas, anotaciones de Post y los campos de conversation ID. Hemos añadido una guía sobre cómo usar fields y expansions juntos en nuestro diccionario de datos de X API v2.