Guía rápida

​

Primeros pasos con los endpoints de consulta de Posts

Esta Guía rápida le ayudará a realizar su primera solicitud a los endpoints de consulta de Posts con un conjunto de fields especificados usando Postman.

Si desea ver Código de muestra en distintos lenguajes, visite nuestro repositorio de GitHub X API v2 sample code.

​

Requisitos previos

Para completar esta guía, necesitará contar con un conjunto de keys and tokens para autenticar su solicitud. Puede generar estas keys and tokens siguiendo estos pasos:

• Regístrese para obtener una cuenta de desarrollador y reciba la aprobación.
• Cree un Project y una App de desarrollador asociada en el portal de desarrolladores.
• Vaya a la página “Keys and tokens” de su App para generar las credenciales necesarias. Asegúrese de guardar todas las credenciales en un lugar seguro.

​

Pasos para crear una solicitud GET /tweets

​

Primer paso: comience con una herramienta o biblioteca

Existen varias herramientas, ejemplos de código y bibliotecas que puede usar para realizar una solicitud a este endpoint, pero aquí usaremos la herramienta Postman para simplificar el proceso.

Para cargar en su entorno la colección de Postman de X API v2, haga clic en el botón a continuación:

Agregar X API v2 a Postman

Una vez que tenga cargada en Postman la colección de X API v2, navegue a la solicitud “Post Lookup > Multiple Posts”.

​

Paso dos: autentica tu solicitud

Para realizar correctamente una solicitud a la X API, debes verificar que tienes permiso. Puedes autenticar tu solicitud con:

• OAuth 2.0 App-Only
• Código de autorización de OAuth 2.0 con PKCE
• Contexto de usuario de OAuth 1.0a

Para simplificar, utilizaremos OAuth 2.0 App-Only con esta solicitud; sin embargo, si deseas solicitar metrics privadas o Posts, deberás usar uno de los otros métodos de autenticación.

Para utilizar OAuth 2.0 App-Only, debes agregar tus keys and tokens (específicamente el App Access Token, también conocido como App-only Bearer Token) en Postman seleccionando el entorno llamado “X API v2” (en la esquina superior derecha de Postman) y agregando tus keys and tokens en los campos “initial value” y “current value” (haciendo clic en el ícono de ojo junto al menú desplegable del entorno).

Si lo has hecho correctamente, estas variables se incorporarán automáticamente en la pestaña de autorización de la solicitud.

​

Paso tres: Identifique y especifique qué Posts desea recuperar

Debe especificar un Post o un conjunto de Posts que desea recibir en la solicitud. Puede encontrar el ID de Post navegando a X.com, haciendo clic en un Post y luego revisando la URL. Por ejemplo, el ID de Post de la siguiente URL es 1228393702244134912.

https://x.com/TwitterDev/status/1228393702244134912

En Postman, vaya a la pestaña “Params” e ingrese este ID, o una cadena de IDs de Post separadas por comas, en la columna “Value” del parámetro ids.

Key	Value
ids	1228393702244134912,1227640996038684673,1199786642791452673

---

​

Paso cuatro: Identificar y especificar qué campos desea recuperar

Si hace clic en el botón “Send” después del paso tres, recibirá en su respuesta los Post object fields predeterminados: id, text y edit_history_tweet_ids.

Para este ejercicio, solicitaremos tres conjuntos adicionales de campos de distintos objetos:

• El campo adicional tweet.created_at en los objetos de usuario primarios.
• Los campos predeterminados del objeto de usuario de los autores asociados para los Posts devueltos: id, name y username
• El campo adicional user.created_at en los objetos de usuario asociados.

En Postman, vaya a la pestaña “Params” y agregue el siguiente par key:value a la tabla “Query Params”:

Key	Value	Returned fields
tweet.fields	created_at	tweets.created_at
expansions	author_id	includes.users.id, includes.users.name, includes.users.username
user.fields	created_at	includes.users.created_at

Debería ver esta URL junto al botón “Send”:

https://api.x.com/2/tweets?ids=1228393702244134912,1227640996038684673,1199786642791452673&tweet.fields=created_at&expansions=author_id&user.fields=created_at

​

Paso cinco: Realiza tu solicitud y revisa la respuesta

Una vez que tengas todo listo, haz clic en el botón “Send” y recibirás la siguiente respuesta:

{
    "data": [
        {
            "edit_history_tweet_ids": [
                "1228393702244134912"
            ],
            "text": "¿Qué escribió el desarrollador en su tarjeta de San Valentín?\n  \nwhile(true) {\n    I = Love(You);  \n}",
            "id": "1228393702244134912",
            "created_at": "2020-02-14T19:00:55.000Z",
            "author_id": "2244994945"
        },
        {
            "edit_history_tweet_ids": [
                "1227640996038684673"
            ],
            "text": "Doctores: Buscar cosas en Google no te convierte en doctor\n\nDesarrolladores: https://t.co/mrju5ypPkb",
            "id": "1227640996038684673",
            "created_at": "2020-02-12T17:09:56.000Z",
            "author_id": "2244994945"
        },
        {
            "edit_history_tweet_ids": [
                "1199786642791452673"
            ],
            "text": "C#",
            "id": "1199786642791452673",
            "created_at": "2019-11-27T20:26:41.000Z",
            "author_id": "2244994945"
        }
    ],
    "includes": {
        "users": [
            {
                "name": "Desarrolladores",
                "created_at": "2013-12-14T04:35:55.000Z",
                "id": "2244994945",
                "username": "XDevelopers"
            }
        ]
    }
}