Passer au contenu principal

​
Bien démarrer avec les endpoints de gestion des Posts**

Ce guide de démarrage rapide vous aidera à effectuer votre première requête vers les endpoints de gestion des Posts à l’aide de Postman. Veuillez consulter notre dépôt GitHub X API v2 sample code si vous souhaitez voir des exemples de code dans différentes langues.
PrérequisPour suivre ce guide, vous aurez besoin d’un ensemble de clés et jetons afin d’authentifier votre requête. Vous pouvez générer ces clés et jetons en suivant ces étapes :
  • Inscrivez-vous à 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 identifiants requis. Veillez à enregistrer toutes les informations d’identification dans un endroit sécurisé.

​
Étapes pour créer des requêtes Manage Posts

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 pour simplifier le processus. Pour charger la collection Postman X API v2 dans votre environnement, veuillez cliquer sur le bouton suivant :
Une fois que vous avez chargé la collection X API v2 dans Postman, accédez au dossier “Manage Posts” et sélectionnez “Create a Post”.   Deuxième étape : authentifiez votre requête Pour effectuer correctement une requête vers la X API, vous devez vérifier que vous êtes autorisé à le faire. Pour ce faire avec les endpoints Manage Posts, vous devez authentifier votre requête en utilisant soit Contexte utilisateur OAuth 1.0a soit 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 (et en particulier votre API Key, votre Clé secrète de l’API, l’Access Token utilisateur OAuth 1.0a et l’Access Token Secret utilisateur OAuth 1.0a) à Postman. Vous pouvez le faire en sélectionnant l’environnement nommé “X API v2” (dans le coin supérieur droit de Postman), puis en ajoutant vos clés et jetons aux champs “initial value” et “current value” (en cliquant sur l’icône en forme d’œil à côté de la liste déroulante des environnements). Si vous avez effectué cette étape correctement, ces variables seront automatiquement renseignées dans l’onglet d’autorisation de la requête. Troisième étape : spécifiez le texte du Post Lors de la création d’un nouveau Post avec cet endpoint, le texte ou les médias du Post sont des paramètres requis du corps de la requête. Dans Postman, accédez à l’onglet “Body” et saisissez le texte du Post comme valeur du paramètre text. En outre, si vous souhaitez ajouter des paramètres pour des éléments tels que des sondages, répondre à un ID de Post ou définir des paramètres de réponse, vous pouvez également le faire ici. Vous pouvez en savoir plus sur ce qui est disponible dans notre guide de référence de l’API.
KeyValueParameter type
textHello world!body
Quatrième étape : identifiez et spécifiez les fields que vous souhaitez récupérer Une fois que tout est configuré, cliquez sur le bouton “Send”, et vous recevrez une réponse similaire à l’exemple suivant : 
{
  "data": {
    "id": "1445880548472328192",
    "text": "Bonjour le monde !"
  }
}
Si l’objet de réponse contient un id et le text de votre Post, vous avez créé un Post avec succès.   Étape cinq : supprimer votre Post Pour supprimer un Post, sélectionnez la requête « Delete a Post » également située dans le dossier « Manage Posts » de la collection X API v2 chargée dans Postman. Cet endpoint requiert l’id du Post que vous souhaitez supprimer. Ensuite, dans l’onglet « Params », saisissez l’id du Post à supprimer comme valeur de la colonne id.  Si la requête DELETE réussit, vous recevrez une réponse similaire à l’exemple suivant : 
{
   "data": {
       "deleted" : true
   }
}
Prochaines étapes Référence de l’API Obtenir de l’aide Exemples de code
⌘I