Saltar al contenido principal

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

Esta guía rápida le ayudará a realizar su primera solicitud a los endpoints para gestionar Posts usando Postman. Visite nuestro repositorio de código de muestra de X API v2 en GitHub si desea ver ejemplos de código en diferentes lenguajes.
Requisitos previosPara completar esta guía, necesitará un conjunto de keys and tokens para autenticar su solicitud. Puede generar estas keys and tokens siguiendo estos pasos:

​
Pasos para crear solicitudes de administración de Posts

Paso uno: Comience con una herramienta o biblioteca Existen varias herramientas, ejemplos de código y bibliotecas que puede usar para hacer 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 hacerlo con los endpoints de administración de Posts, debe autenticar su solicitud usando OAuth 1.0a User Context o OAuth 2.0 Authorization Code with PKCE. En este ejemplo, usaremos OAuth 1.0a User Context. Debe agregar sus keys and tokens (y específicamente su API Key, Clave secreta de la API, 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 keys and tokens a 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 elementos multimedia 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 para el parámetro text. Además, si desea agregar parámetros para elementos como encuestas, responder a un ID de Post o agregar configuraciones de respuesta, también puede hacerlo aquí. Puede obtener más información sobre lo 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, haga clic en 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 correctamente un Post.   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 de la columna id.  Si la solicitud DELETE se realiza correctamente, recibirás una respuesta similar al siguiente ejemplo: 
{
   "data": {
       "deleted" : true
   }
}
Próximos pasos Referencia de la API Obtener ayuda Código de muestra
⌘I