Saltar al contenido principal

​
Introducción a los endpoints para gestionar follows

Esta Guía rápida le ayudará a realizar su primera solicitud a los endpoints para gestionar follows con Postman. Si desea ver código de muestra en distintos lenguajes, visite nuestro repositorio de X API v2 sample code en GitHub. 

​
Requisitos previos

Para 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 una solicitud para gestionar follows

​
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 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 cargada la colección de X API v2 en Postman, navegue a la carpeta “Follows” y seleccione “Follow a user ID”.  

​
Paso dos: autentique su solicitud

Para realizar correctamente una solicitud a la X API, debe verificar que tiene permiso. Para hacerlo con este endpoint, 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 el Contexto de usuario de OAuth 1.0a. Debe agregar sus keys and tokens —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). Estas variables se insertarán automáticamente en la pestaña de autorización de la solicitud si lo ha hecho correctamente.  

​
Paso tres: especifica quién va a seguir a quién

Los endpoints de gestión de seguimientos aceptan dos ID: uno para el usuario de origen (el usuario que desea seguir o dejar de seguir a otro usuario) y otro para el usuario de destino (el usuario que será seguido o dejado de seguir). El ID del usuario de origen debe corresponder al ID de usuario del usuario autenticado. En este caso, puedes especificar el ID de tu propio usuario. Puedes encontrar tu ID de dos maneras:
  1. Usando el endpoint user lookup by username, puedes proporcionar un nombre de usuario y recibir el campo id.
  2. Revisando tu Access Token, verás que la parte numérica es tu ID de usuario.
El ID de destino puede ser cualquier ID de usuario válido. Por ejemplo, el ID de usuario de @XDevelopers es 2244994945. En Postman, ve a la pestaña “Params” e introduce tu ID en la columna “Value” de la variable de ruta id. Ve a la pestaña “Body” y agrega 2244994945 (el ID de usuario de @XDevelopers) como valor del parámetro target_user_id. Asegúrate de no incluir espacios antes o después de ningún ID.
KeyValue
id(tu ID de usuario)
target_user_id2244994945
Si haces clic en el botón “Send”, recibirás un objeto de respuesta que contiene el estado de la relación:
  • Si recibes “following”: true, entonces el id está siguiendo correctamente a target_user_id.
  • Si recibes “pending”: true, entonces target_user_id está protegido y debe aceptar tu solicitud de seguimiento.

​

Paso cuatro: Realiza 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": {
        "following": true,
        "pending_follow": false
    }
}
De manera similar, si intentaras dejar de seguir a un usuario, utilizarías la solicitud “Unfollow a user ID” dentro de la misma colección de Postman. No obstante, tanto los parámetros source_user_id como target_user_id deben pasarse como variables de ruta al usar el endpoint de unfollow.
⌘I