Saltar al contenido principal

​
Getting started with the hide replies endpoint

Esta guía de inicio rápido le ayudará a realizar su primera solicitud al endpoint para ocultar respuestas usando Postman. Si desea ver fragmentos de código en diferentes lenguajes, visite la página de referencia del API para ocultar respuestas. 

​
Requisitos previos

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

​
Pasos para crear una solicitud PUT a /tweets/:id/hidden

​
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 en su entorno la colección de Postman de X API v2, haga clic en el siguiente botón:
Una vez que tenga cargada en Postman la colección de X API v2, navegue al endpoint para ocultar respuestas.

​
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 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 añadiendo sus claves y tokens a los campos “initial value” y “current value” (haciendo clic en el icono del ojo junto al menú desplegable del entorno). Estas variables se incorporarán automáticamente en la pestaña de autorización de la solicitud si lo ha hecho correctamente.  

​
Paso tres: Encontrar un ID de Post para ocultar

El endpoint de ocultar respuestas puede ocultar o dejar de ocultar respuestas en nombre de un usuario autorizado. Como en este ejemplo usamos Tokens de Acceso vinculados a tu perfil de usuario, podrás ocultar respuestas de usuarios que participen en una conversación iniciada por ti. De manera similar, si usaras Tokens de Acceso que pertenecen a otro usuario que autorizó tu App, podrías moderar las respuestas de cualquier conversación iniciada por esa cuenta. Pídele a un amigo que responda a un Post (avísale que estás probando la función de ocultar respuestas) o responde a cualquiera de tus Posts desde una cuenta de prueba. Haz clic en esa respuesta y luego copia la parte numérica de su URL. Ese será el ID del Post que ocultaremos. En este caso, veremos el siguiente Post, que tiene el ID 1232720193182412800: https://x.com/TwitterDev/status/1232720193182412800

​
Paso cuatro: Ocultar el Post

En Postman, abre la carpeta Hide replies y selecciona Hide a reply. En la pestaña Params, pega el id del Post junto al campo id (no es necesario reemplazar :id en la URL). Haz clic en “Send” y verás una respuesta satisfactoria. {"hidden":true}

​
Paso cinco: Mostrar el Post

Los Posts ocultos se mueven a una pestaña separada en la app de X. Para mostrar un Post en Postman, abre la carpeta Hide replies y selecciona Unhide a reply. En la pestaña Params, pega el mismo Post ID usado en el paso anterior en el campo id. Haz clic en “Send” y verás una respuesta satisfactoria. {"hidden":false} El campo hidden representa el estado de ocultación del Post. Un estado de ocultación true significa que el Post está oculto. Del mismo modo, false significa que el Post no está oculto.