Saltar al contenido principal
Esta guía te llevará por algunos pasos que puedes seguir para realizar tu primera solicitud. Es un excelente recurso para ayudarte una vez que te hayas registrado en una cuenta de X. Si te interesa usar ejemplos de código, guías más técnicas o una herramienta gráfica como Postman, considera las siguientes guías para hacer tu primera solicitud: Esta guía asume que has recopilado tu API key and secret, user Access Token and Secret, App Access Token, y que los has almacenado en un lugar seguro. Puedes aprender cómo hacerlo siguiendo los pasos en la guía obtener acceso a la X API.

​
Paso 1. Identifique qué endpoint desea usar

La X API le permite realizar diversas acciones mediante código que también podría realizar en el sitio web o la aplicación móvil de X. Tenemos un listado completo de los endpoints disponibles a través de la API en nuestro Índice de referencia de la API, pero recomendamos ceñirse a uno de los siguientes por simplicidad:

​
Paso 2. Elige una herramienta para hacer tu solicitud

Si bien algunas solicitudes pueden ser sencillas, otras pueden resultar más complejas de implementar. Por eso, la extraordinaria comunidad de desarrolladores ha creado herramientas que abstraen parte de esa complejidad. A continuación, encontrarás algunas herramientas recomendadas y detalles sobre cómo utilizarlas:

​
Postman

Postman es una herramienta visual que puedes usar para realizar solicitudes a endpoints REST. Hemos creado materiales muy útiles sobre Postman para ayudarte a comenzar y explorar los distintos endpoints disponibles mediante la X API. Te recomendamos leer nuestro tutorial “Primeros pasos con Postman” para aprender a añadir tus claves y tokens y realizar tu primera solicitud. También hemos preparado una guía de inicio rápido para cada uno de nuestros endpoints de la X API v2, la mayoría de los cuales usan Postman. Puedes encontrar estas guías en la sección del endpoint correspondiente, pero aquí tienes enlaces a algunas:
  • Inicio rápido: Publicar un Tweet
  • Inicio rápido: Buscar Posts
  • Inicio rápido: Consultar un usuario
Ten en cuenta que no puedes realizar solicitudes a endpoints de streaming usando Postman. Visita la guía de inicio rápido de filtered stream o 1% sampled stream para aprender a trabajar con esos endpoints. Si prefieres una herramienta gráfica más sencilla, también puedes considerar usar Insomnia.

​
Código de ejemplo

Si le interesa usar código sencillo para realizar su solicitud, hemos preparado ejemplos de código en varios lenguajes para cada uno de nuestros endpoints de X API v2. Puede encontrar los ejemplos en nuestro repositorio de GitHub, X-API-v2-sample-code, que también contiene un archivo README que puede usar para aprender a configurar sus credenciales y trabajar correctamente con las solicitudes. Por ejemplo, a continuación se muestra un ejemplo de cURL para el endpoint de búsqueda de usuarios. Todo lo que debe hacer para usar esta solicitud es reemplazar ACCESS_TOKEN y USERNAME por su App Access Token y su usuario de X. Luego, copie y pegue este código en su herramienta de línea de comandos y presione “Return” o “Enter”. 
curl "https://api.x.com/2/users/by/username/$USERNAME" -H "Authorization: Bearer $ACCESS_TOKEN"

​
Bibliotecas

La increíble comunidad de desarrolladores de X también ha creado bibliotecas en diversos lenguajes de programación que pueden usarse para realizar solicitudes a la X API. Hemos creado una página de “Herramientas y bibliotecas” que enumera todas las bibliotecas de la comunidad que conocemos. Cada biblioteca debería incluir un archivo README con instrucciones para configurar el repositorio en tu máquina y realizar tu primera solicitud.
Ten en cuenta: Si te encuentras con algún problema, consulta nuestra documentación para desarrolladores del endpoint al que estás realizando la solicitud, nuestra sección de soporte o ponte en contacto con la comunidad en nuestros foros para obtener ayuda. ¡Te ayudaremos a completar una solicitud con éxito!

​
Paso 3. Revisa la respuesta

Una vez que hayas realizado una solicitud correcta, recibirás un payload con metadatos relacionados con la solicitud. Si utilizaste un endpoint que emplea el método HTTP GET, recibirás metadatos relacionados con el recurso (Post, usuario, lista, Space, etc.) al que hiciste la solicitud, en formato JSON. Revisa los distintos fields que se devolvieron y verifica si puedes asociar la información que solicitaste con el contenido en X. Si utilizaste un endpoint que emplea los métodos HTTP POST, PUT o DELETE, realizaste una acción en X. Ve a X.com o a la App móvil y verifica si puedes localizar esa acción.

​
Paso 4. Ajusta tu solicitud usando parámetros

Cada endpoint tiene un conjunto diferente de parámetros que puedes usar para modificar tu solicitud. Por ejemplo, puedes solicitar campos de metadatos adicionales cuando uses endpoints GET con los parámetros fields y expansions. También puedes probar distintas herramientas de filtrado con endpoints como búsqueda de Posts, recuento de Posts y flujo filtrado para acotar los datos que recibes a solo aquellos Posts que te interesan. Puedes encontrar una lista completa de los parámetros de solicitud y fields en la Referencia de la API del endpoint con el que estés trabajando, además de mucha otra información útil para la integración en nuestras guías y páginas de conceptos fundamentales. Puedes obtener más información sobre todos los materiales educativos que hemos puesto a tu disposición en nuestra guía de Recursos importantes.