Démarrage rapide : utilisateur authentifié

Obtenir le profil de l’utilisateur actuellement authentifié

Ce guide vous explique comment récupérer le profil de l’utilisateur actuellement authentifié à l’aide du point de terminaison /me.

Prérequis

Avant de commencer, vous aurez besoin de :

• Un compte développeur avec une App approuvée
• Un jeton d’accès utilisateur (OAuth 1.0a ou OAuth 2.0 PKCE)

---

​

Récupérer l’utilisateur authentifié

Envoyez une requête au point de terminaison /me avec un jeton d’accès utilisateur :

cURL

shellscript

curl "https://api.x.com/2/users/me?\
user.fields=created_at,description,verified,public_metrics,profile_image_url" \
  -H "Authorization: Bearer $USER_ACCESS_TOKEN"

---

​

Réponse

{
  "data": {
    "id": "2244994945",
    "name": "X Developers",
    "username": "XDevelopers",
    "created_at": "2013-12-14T04:35:55.000Z",
    "description": "The voice of the X developer community",
    "verified": true,
    "profile_image_url": "https://pbs.twimg.com/profile_images/...",
    "public_metrics": {
      "followers_count": 583423,
      "following_count": 2048,
      "tweet_count": 14052,
      "listed_count": 1672
    }
  }
}

---

​

Cas d’utilisation

L’endpoint /me est essentiel dans les cas suivants :

• Vérifier l’authentification — Confirmer que l’utilisateur est correctement authentifié
• Obtenir l’ID utilisateur — Récupérer l’ID de l’utilisateur authentifié pour d’autres appels d’API
• Personnaliser les expériences — Afficher le profil de l’utilisateur dans votre application
• Requêtes pour le compte d’un utilisateur — Savoir pour le compte de qui vous effectuez des requêtes

---

​

Inclure la Publication épinglée

Récupérer la Publication épinglée de l’utilisateur :

cURL

shellscript

curl "https://api.x.com/2/users/me?\
user.fields=pinned_tweet_id&\
expansions=pinned_tweet_id&\
tweet.fields=created_at,text" \
  -H "Authorization: Bearer $USER_ACCESS_TOKEN"

​

Réponse avec expansions

{
  "data": {
    "id": "2244994945",
    "name": "X Developers",
    "username": "XDevelopers",
    "pinned_tweet_id": "1234567890"
  },
  "includes": {
    "tweets": [
      {
        "id": "1234567890",
        "text": "Welcome to my profile!",
        "created_at": "2024-01-01T00:00:00.000Z"
      }
    ]
  }
}

---

​

Champs disponibles

Champ	Description
created_at	Date de création du compte
description	Bio de l’utilisateur
profile_image_url	URL de l’avatar
verified	Statut de vérification
public_metrics	Nombre d’abonnés/abonnements
location	Localisation renseignée par l’utilisateur
url	Site web de l’utilisateur
protected	Statut de compte protégé
pinned_tweet_id	ID de la Publication épinglée

---

​

Conditions d’authentification

L’endpoint /me requiert une authentification en contexte utilisateur (User Context). L’authentification App-Only (Jeton Bearer) n’est pas prise en charge.

Utilisez l’une des méthodes suivantes :

• OAuth 1.0a User Context
• OAuth 2.0 Authorization Code with PKCE

---

​

Prochaines étapes

Recherche d’utilisateurs

Rechercher d’autres utilisateurs

Guide d’intégration

Concepts clés et bonnes pratiques

Référence de l’API

Documentation complète de l’endpoint