Saltar al contenido principal

​
Introducción al endpoint para ocultar respuestas

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

​
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 PUT /tweets/:id/hidden

​
Paso uno: Comienza con una herramienta o biblioteca

Hay varias herramientas, ejemplos de código y bibliotecas que puedes usar para realizar una solicitud a este endpoint, pero aquí usaremos Postman para simplificar el proceso. Para cargar en tu entorno la colección de Postman de X API v2, haz clic en el siguiente botón:
Una vez que tengas cargada en Postman la colección de X API v2, navega al endpoint de 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 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 incorporarán automáticamente en la pestaña de autorización de la solicitud si lo ha hecho correctamente.  

​
Paso tres: Buscar un ID de Post para ocultar

El endpoint de ocultar respuestas puede ocultar o desocultar respuestas en nombre de un usuario autorizado. Como en este ejemplo estamos usando los Access Tokens asociados a tu perfil de usuario, podrás ocultar respuestas de usuarios que participen en una conversación iniciada por ti. Del mismo modo, si estuvieras usando Access Tokens que pertenecen a otro usuario que autorizó tu App, podrías moderar las respuestas en 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 de 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 de Post junto al campo id (no necesitas reemplazar :id en la URL). Haz clic en “Send” y verás una respuesta correcta. {"hidden":true}

​
Paso cinco: Mostrar el Post

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