Guía rápida

​

Introducción a los endpoints de consulta de Posts

Esta guía de inicio rápido 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 ejemplos de código 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 developer account y reciba la aprobación.
• Cree un Project y una developer App 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 construir una solicitud GET /tweets

​

Paso uno: Comience con una herramienta o biblioteca

Hay varias herramientas, ejemplos de código y bibliotecas que puede usar para realizar una solicitud a este endpoint, pero aquí utilizaremos 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 de abajo:

Agregar X API v2 a Postman

Una vez que tenga cargada la colección de X API v2 en Postman, vaya 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 en esta solicitud, pero 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 y tokens (en particular el App Access Token, también conocido como App-only Bearer Token) en Postman seleccionando el entorno denominado “X API v2” (en la esquina superior derecha de Postman) y añadiendo tus keys y tokens en los campos “initial value” y “current value” (haciendo clic en el icono de ojo junto al selector de entorno).

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

​

Paso tres: Identificar y especificar qué Posts desea recuperar

Debe especificar un Post o un conjunto de Posts que desea recibir en la solicitud. Puede encontrar el id del Post navegando a X.com, haciendo clic en un Post y luego consultando la URL. Por ejemplo, el id del Post en 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 lista de ids de Posts separados por comas, en la columna “Value” del parámetro ids.

Key	Value
ids	1228393702244134912,1227640996038684673,1199786642791452673

---

​

Paso cuatro: Identifique y especifique qué campos desea recuperar

Si hace clic en el botón “Send” después del paso tres, recibirá en su respuesta los campos del objeto Post 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 principales.
• 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: Haz tu solicitud y revisa la respuesta

Una vez que tengas todo configurado, 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 en Google no te hace médico\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"
            }
        ]
    }
}