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

​
Herramientas útiles

Antes de profundizar en algunos conceptos clave que le ayudarán a integrar este endpoint, le recomendamos familiarizarse con:

​
Postman

Postman es una excelente herramienta para probar un endpoint. Cada solicitud de Postman incluye todos los parámetros de ruta y de cuerpo para ayudarle a comprender rápidamente qué opciones tiene disponibles. Para obtener más información sobre nuestras colecciones de Postman, visite nuestra página “Using Postman”. 

​
Ejemplos de código

¿Le interesa configurar este endpoint con código en su lenguaje de programación preferido? Disponemos de varios ejemplos de código que puede usar como punto de partida en nuestra página de GitHub.

​
Bibliotecas de terceros

Aproveche una de las bibliotecas de terceros de nuestra comunidad para comenzar. Puede encontrar una biblioteca compatible con los endpoints de 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 keys and tokens. Puedes usar OAuth 1.0a User Context u OAuth 2.0 Bearer Token para autenticar tus solicitudes al endpoint de consulta de Retweets. Los endpoints para administrar Retweets requieren el uso de OAuth 1.0a User Context, lo que significa que debes usar un conjunto de API Keys y Access Tokens de usuario para realizar una solicitud correcta. 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 complicado 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 OAuth 1.0a User Context:
  • 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, Projects y Apps de desarrollador

Para obtener un conjunto de credenciales de autenticación que funcione con los endpoints de la X API v2, debes registrarte para una cuenta de desarrollador, configurar un Project dentro de esa cuenta y crear una App de desarrollador dentro de ese Project. Luego podrás encontrar tus keys and tokens dentro de tu App de desarrollador.   

​
Límites de velocidad

Cada día, miles de desarrolladores realizan solicitudes a la X API. Para gestionar el elevado volumen de estas solicitudes, se aplican límites de velocidad 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 15 min (por usuario). Además, para el endpoint POST, estás limitado a 300 solicitudes por ventana de 3 horas (por usuario y por App).  Con el endpoint de búsqueda de Retweets, estás limitado a 75 solicitudes por ventana de 15 min. Además, este endpoint solo devolverá a los 100 usuarios que hayan hecho Retweet más recientes.

​
Campos y expansions

La X API v2 permite seleccionar exactamente qué data deseas obtener de la API mediante un conjunto de herramientas llamadas fields y expansions. El parámetro expansions permite ampliar los objetos referenciados en el payload. Por ejemplo, este endpoint 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 permite seleccionar exactamente qué fields dentro de los diferentes objetos de data deseas recibir. Estos endpoints entregan principalmente el Objeto de Post. De forma predeterminada, el Objeto de Post devuelve los campos id y text. Para recibir campos adicionales como tweet.created_at o tweet.entities, deberás solicitarlos específicamente usando el parámetro fields. Algunos fields importantes que podrías considerar en tu integración son los datos de encuestas, metrics, Post annotations y los campos de conversation ID. Hemos añadido una guía sobre cómo usar fields y expansions conjuntamente en nuestro diccionario de datos de X API v2.
⌘I