Saltar al contenido principal

​
Introducción a los endpoints para administrar Posts**

Esta guía de inicio rápido le ayudará a realizar su primera solicitud a los endpoints para administrar Posts con Postman. Visite nuestro repositorio de GitHub X API v2 sample code si desea ver código de ejemplo en distintos idiomas.
Requisitos previosPara completar esta guía, necesitará un conjunto de claves y tokens para autenticar su solicitud. Puede generar estas claves y tokens siguiendo estos pasos:

​
Pasos para crear solicitudes de manage Posts

Paso uno: 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 la colección de Postman de X API v2 en su entorno, haga clic en el siguiente botón:
Una vez que tenga la colección de X API v2 cargada en Postman, navegue a la carpeta “Manage Posts” y seleccione “Create a Post”.   Paso dos: Autentique su solicitud Para realizar correctamente una solicitud a la X API, debe verificar que tiene permiso para hacerlo. Para ello, con los endpoints de manage Posts, debe autenticar su solicitud usando Contexto de usuario de OAuth 1.0a o Código de autorización de OAuth 2.0 con PKCE. En este ejemplo, usaremos Contexto de usuario de OAuth 1.0a. Debe agregar sus claves y tokens (específicamente su API Key, API Secret Key, OAuth 1.0a user Access Token y OAuth 1.0a user Access Token Secret) a Postman. Puede hacerlo seleccionando el entorno llamado “X API v2” (en la esquina superior derecha de Postman) y agregando sus claves y tokens en los campos “initial value” y “current value” (haciendo clic en el ícono de ojo junto al menú desplegable del entorno). Si lo ha hecho correctamente, estas variables se incorporarán automáticamente en la pestaña de autorización de la solicitud. Paso tres: Especifique el texto del Post Al crear un nuevo Post con este endpoint, el texto o los medios del Post son los parámetros obligatorios del cuerpo. En Postman, navegue a la pestaña “Body” e ingrese el texto del Post como el valor del parámetro text. Además, si desea agregar parámetros para elementos como encuestas, responder a un Post ID o agregar configuraciones de respuesta, también puede hacerlo aquí. Puede obtener más información sobre lo que está disponible en nuestra guía de referencia de la API.
KeyValueParameter type
textHello world!body
Paso cuatro: Identifique y especifique qué fields desea recuperar Una vez que tenga todo configurado, presione el botón “Send” y recibirá una respuesta similar al siguiente ejemplo de respuesta: 
{
  "data": {
    "id": "1445880548472328192",
    "text": "¡Hola mundo!"
  }
}
Si el objeto de respuesta devuelto contiene un id y el text de tu Post, has creado un Post correctamente.   Paso cinco: Eliminar tu Post Para eliminar un Post, selecciona la solicitud “Delete a Post”, que también se encuentra en la carpeta “Manage Posts” de la colección de X API v2 cargada en Postman. Este endpoint requiere el ID del Post que deseas eliminar. Luego, en la pestaña “Params”, ingresa el ID del Post que deseas eliminar como valor en la columna id.  Si la solicitud de eliminación se realiza correctamente, recibirás una respuesta similar al siguiente ejemplo: 
{
   "data": {
       "deleted" : true
   }
}
Próximos pasos Referencia de la API Obtener ayuda Ejemplos de código