Prise en main

​

Bien démarrer avec les endpoints de recherche de Posts

Ce guide de démarrage rapide vous aidera à effectuer votre première requête vers les endpoints de recherche de Posts avec un ensemble de fields spécifiés, à l’aide de Postman.

Si vous souhaitez voir des exemples de code dans différents langages, veuillez consulter notre dépôt GitHub Exemples de code X API v2.

​

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 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 emplacement sécurisé.

​

Étapes pour construire une requête GET /tweets

​

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 envoyer une requête à cet endpoint, mais nous allons utiliser Postman ici pour simplifier le processus.

Pour charger la collection X API v2 de Postman dans votre environnement, cliquez sur le bouton ci-dessous :

Ajouter X API v2 à Postman

Une fois la collection X API v2 chargée dans Postman, accédez à la requête « Post Lookup > Multiple Posts ».

​

Deuxième étape : Authentifiez votre requête

Pour effectuer correctement une requête vers la X API, vous devez vérifier que vous avez l’autorisation. Vous pouvez authentifier votre requête avec :

• OAuth 2.0 App-Only
• OAuth 2.0 Autorisation par code avec PKCE
• Contexte utilisateur OAuth 1.0a

Pour simplifier, nous allons utiliser OAuth 2.0 App-Only pour cette requête, mais si vous souhaitez accéder à des métriques ou à des Posts privés, vous devrez utiliser l’une des autres méthodes d’authentification.

Pour utiliser OAuth 2.0 App-Only, vous devez ajouter vos clés et jetons (et en particulier l’App Access Token, également appelé App-only Bearer Token) dans Postman 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 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).

Si vous avez effectué cette opération correctement, ces variables seront automatiquement renseignées dans l’onglet Authorization de la requête.

​

Étape trois : Identifiez et indiquez les Posts que vous souhaitez récupérer

Vous devez indiquer un Post ou un ensemble de Posts à renvoyer dans la requête. Vous pouvez trouver l’ID de Post en vous rendant sur X.com, en cliquant sur un Post, puis en consultant l’URL. Par exemple, l’ID de Post de l’URL suivante est 1228393702244134912.

https://x.com/TwitterDev/status/1228393702244134912

Dans Postman, ouvrez l’onglet « Params » et saisissez cet ID, ou une liste d’ID de Post séparés par des virgules, dans la colonne « Value » du paramètre ids.

Key	Value
ids	1228393702244134912,1227640996038684673,1199786642791452673

---

​

Quatrième étape : identifier et spécifier les fields que vous souhaitez récupérer

Si vous cliquez sur le bouton « Send » après l’étape trois, vous recevrez dans votre réponse les champs par défaut de l’Objet Post : id, text et edit_history_tweet_ids.

Pour cet exercice, nous allons demander trois ensembles supplémentaires de fields provenant d’objets différents :

• Le tweet.created_at field supplémentaire dans les objets utilisateur principaux.
• Les fields par défaut de l’objet utilisateur des auteurs associés pour les Posts renvoyés : id, name et username
• Le user.created_at field supplémentaire dans les objets utilisateur associés.

Dans Postman, accédez à l’onglet « Params » et ajoutez la paire key:value suivante au tableau « Query Params » :

Key	Value	Returned fields
tweet.fields	created_at	tweets.created_at
expansions	author_id	includes.users.id, includes.users.name, includes.users.username
user.fields	created_at	includes.users.created_at

Vous devriez voir cette URL à côté du bouton « Send » :

https://api.x.com/2/tweets?ids=1228393702244134912,1227640996038684673,1199786642791452673&tweet.fields=created_at&expansions=author_id&user.fields=created_at

​

Cinquième étape : Envoyez votre requête et examinez la réponse

Une fois tout configuré, cliquez sur le bouton « Send » pour recevoir la réponse suivante :

{
    "data": [
        {
            "edit_history_tweet_ids": [
                "1228393702244134912"
            ],
            "text": "Qu'est-ce que le développeur a écrit dans sa carte de Saint-Valentin ?\n  \nwhile(true) {\n    I = Love(You);  \n}",
            "id": "1228393702244134912",
            "created_at": "2020-02-14T19:00:55.000Z",
            "author_id": "2244994945"
        },
        {
            "edit_history_tweet_ids": [
                "1227640996038684673"
            ],
            "text": "Médecins : Chercher des trucs sur Google ne fait pas de vous un médecin\n\nDéveloppeurs : https://t.co/mrju5ypPkb",
            "id": "1227640996038684673",
            "created_at": "2020-02-12T17:09:56.000Z",
            "author_id": "2244994945"
        },
        {
            "edit_history_tweet_ids": [
                "1199786642791452673"
            ],
            "text": "C#",
            "id": "1199786642791452673",
            "created_at": "2019-11-27T20:26:41.000Z",
            "author_id": "2244994945"
        }
    ],
    "includes": {
        "users": [
            {
                "name": "Développeurs",
                "created_at": "2013-12-14T04:35:55.000Z",
                "id": "2244994945",
                "username": "XDevelopers"
            }
        ]
    }
}