Passer au contenu principal

​
Bien démarrer avec l’endpoint de masquage des réponses

Ce guide de démarrage rapide vous aidera à effectuer votre première requête vers l’endpoint de masquage des réponses à l’aide de Postman. Si vous souhaitez voir des extraits de code dans différents langages, veuillez consulter la page de référence de l’API de masquage des réponses. 

​
Prérequis

Pour suivre ce guide, vous aurez besoin d’un ensemble de clés et jetons pour authentifier votre requête. Vous pouvez générer ces clés et jetons en suivant ces étapes :
  • Inscrivez-vous pour obtenir un compte développeur et obtenez l’approbation.
  • Créez un Project et une App développeur associée dans le developer portal.
  • Accédez à la page « Keys and tokens » de votre App pour générer les informations d’identification requises. Assurez-vous d’enregistrer toutes les informations d’identification dans un emplacement sécurisé.

​
Étapes pour créer une requête PUT /tweets/:id/hidden

​
Première étape : commencez avec un outil ou une bibliothèque

Il existe plusieurs outils, exemples de code et bibliothèques que vous pouvez utiliser pour effectuer une requête vers cet endpoint, mais nous allons utiliser l’outil Postman ici afin de simplifier le processus. Pour importer la collection Postman X API v2 dans votre environnement, veuillez cliquer sur le bouton suivant :
Une fois la collection X API v2 chargée dans Postman, accédez à l’endpoint « hide replies ».

​
Deuxième étape : authentifier votre requête

Pour effectuer correctement une requête vers la X API, vous devez vérifier que vous disposez des autorisations nécessaires. Pour ce faire avec cet endpoint, vous devez authentifier votre requête à l’aide de OAuth 1.0a User Context ou de OAuth 2.0 Authorization Code with PKCE. Dans cet exemple, nous allons utiliser le Contexte utilisateur OAuth 1.0a. Vous devez ajouter vos clés et jetons — en particulier votre API Key, votre Clé secrète de l’API, votre access token utilisateur OAuth 1.0a et votre Access Token Secret utilisateur OAuth 1.0a — dans Postman. Pour cela, sélectionnez l’environnement nommé « X API v2 » dans l’angle supérieur droit de Postman, puis ajoutez vos clés et jetons dans les champs « initial value » et « current value » (en cliquant sur l’icône en forme d’œil à côté du menu déroulant de l’environnement). Ces variables seront automatiquement renseignées dans l’onglet Authorization de la requête si l’opération a été effectuée correctement.  

​
Troisième étape : trouver un ID de Post à masquer

L’endpoint de masquage des réponses peut masquer ou réafficher des réponses pour le compte d’un utilisateur autorisé. Comme nous utilisons, dans cet exemple, les Access Tokens liés à votre profil utilisateur, vous pourrez masquer les réponses d’utilisateurs participant à une conversation que vous avez initiée. De même, si vous utilisiez des Access Tokens appartenant à un autre utilisateur ayant autorisé votre App, vous pourriez modérer les réponses à toute conversation démarrée par ce compte. Demandez à un ami de répondre à un Post (précisez que vous testez la fonctionnalité de masquage des réponses) ou répondez à l’un de vos Posts depuis un compte de test. Cliquez sur cette réponse, puis copiez la partie numérique de son URL. Ce sera l’ID de Post que nous allons masquer. Dans ce cas, nous allons examiner le Post suivant, qui a pour ID 1232720193182412800 : https://x.com/TwitterDev/status/1232720193182412800

​
Quatrième étape : masquer le Post

Dans Postman, ouvrez le dossier Hide replies et sélectionnez Hide a reply. Dans l’onglet Params, collez l’ID de Post à côté du champ id (vous n’avez pas besoin de remplacer :id dans l’URL). Cliquez sur « Send » et vous verrez une réponse réussie. {"hidden":true}

​
Cinquième étape : réafficher le Post

Les Posts masqués sont déplacés dans un onglet séparé de l’application X. Pour réafficher un Post dans Postman, ouvrez le dossier Hide replies et sélectionnez Unhide a reply. Dans l’onglet Params, collez le même ID de Post utilisé à l’étape précédente dans le champ id. Cliquez sur « Send » et vous verrez une réponse indiquant la réussite de l’opération. {"hidden":false} Le champ hidden indique l’état de masquage du Post. Une valeur true signifie que le Post est masqué. Inversement, false signifie que le Post n’est pas masqué.
⌘I