Saltar al contenido principal
Esta guía te conducirá por algunos pasos que puedes seguir para realizar tu primera solicitud. Es un excelente recurso para ayudarte una vez que hayas creado una cuenta en 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 realizar 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 de la guía Getting access to the X API.

​
Paso 1. Identifica qué endpoint deseas usar

La X API permite realizar diversas acciones mediante código que también podrías ejecutar en el sitio web o en la aplicación móvil de X. Contamos con una lista completa de los endpoints disponibles a través de la API en nuestro Índice de referencia de la API, pero recomendamos limitarte a uno de los siguientes por simplicidad:

​
Paso 2. Elige una herramienta para realizar tu solicitud

Si bien algunas solicitudes pueden ser sencillas, otras pueden ser 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 excelentes materiales sobre Postman para ayudarte a comenzar y explorar los diferentes endpoints disponibles a través de la X API. Te recomendamos leer nuestro tutorial “Primeros pasos con Postman” para aprender cómo agregar tus keys and tokens y realizar tu primera solicitud. También hemos producido una Guía rápida para cada uno de nuestros endpoints de X API v2, la mayoría de los cuales usan Postman. Puedes encontrar estas guías en la sección de cada endpoint correspondiente, pero aquí tienes enlaces a algunas:
  • Guía rápida: Publicar un Tweet
  • Guía rápida: Buscar Posts
  • Guía rápida: Consultar un usuario
Ten en cuenta que no puedes realizar solicitudes a endpoints de stream usando Postman. Visita la Guía rápida de stream filtrado o stream muestreado del 1% 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 muestra

Si le interesa usar código sencillo para realizar su solicitud, hemos preparado código de muestra en varios lenguajes para cada uno de nuestros endpoint de la X API v2. Puede encontrar los ejemplos de código 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, aquí tiene un ejemplo de cURL para el endpoint de búsqueda de usuarios. Todo lo que tiene que hacer para usar esta solicitud es reemplazar ACCESS_TOKEN y USERNAME por su App Access Token y su handle 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 hacer solicitudes a la X API. Hemos creado una página de “Herramientas y bibliotecas” que enumera todas las bibliotecas de la comunidad de las que tenemos conocimiento. Cada biblioteca debería contar con un archivo README que puedas usar para aprender a configurar el repositorio en tu máquina y realizar tu primera solicitud.
Ten en cuenta: Si encuentras algún problema, consulta nuestra documentación para desarrolladores del endpoint al que estás realizando la solicitud, nuestra sección de soporte o comunícate 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 metadata relacionada con la solicitud. Si utilizaste un endpoint que emplea el método HTTP GET, recibirás metadata relacionada con el recurso (Post, user, List, Space, etc.) al que hiciste la solicitud en formato JSON. Revisa los diferentes fields que se devolvieron y verifica si puedes mapear 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 con parámetros

Cada endpoint tiene un conjunto distinto de parámetros que puedes usar para modificar tu solicitud. Por ejemplo, puedes solicitar campos de metadata adicionales cuando uses endpoints GET con los parámetros fields y expansions. También puedes experimentar con diversas herramientas de filtrado mediante endpoints como search Posts, Post counts y filtered stream para acotar los datos que recibes únicamente a aquellos Posts que te interesan. Puedes encontrar una lista completa de los parámetros de solicitud y de fields en la API Reference del endpoint con el que estés trabajando, además de mucha otra información útil para la integración en nuestras guías de integración y en las páginas de fundamentos. Puedes obtener más información sobre todos los materiales educativos que hemos puesto a tu disposición en nuestra guía de Important resources.
⌘I