Démarrage rapide : utilisateur authentifié

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

PrérequisAvant 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

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"

from xdk import Client

client = Client(bearer_token="YOUR_USER_ACCESS_TOKEN")

# Récupérer l’utilisateur authentifié
response = client.users.get_me(
    user_fields=["created_at", "description", "verified", "public_metrics", "profile_image_url"]
)

print(f"Username: {response.data.username}")
print(f"ID: {response.data.id}")
print(f"Followers: {response.data.public_metrics.followers_count}")

import { Client } from "@xdevplatform/xdk";

const client = new Client({ accessToken: "YOUR_USER_ACCESS_TOKEN" });

// Récupérer l’utilisateur authentifié
const response = await client.users.getMe({
  userFields: ["created_at", "description", "verified", "public_metrics", "profile_image_url"],
});

console.log(`Username: ${response.data?.username}`);
console.log(`ID: ${response.data?.id}`);
console.log(`Followers: ${response.data?.public_metrics?.followers_count}`);

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

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"

from xdk import Client

client = Client(bearer_token="YOUR_USER_ACCESS_TOKEN")

# Récupérer l’utilisateur authentifié avec sa Publication épinglée
response = client.users.get_me(
    user_fields=["pinned_tweet_id"],
    expansions=["pinned_tweet_id"],
    tweet_fields=["created_at", "text"]
)

print(f"Username: {response.data.username}")
# La Publication épinglée est disponible dans response.includes.tweets

import { Client } from "@xdevplatform/xdk";

const client = new Client({ accessToken: "YOUR_USER_ACCESS_TOKEN" });

// Récupérer l’utilisateur authentifié avec sa Publication épinglée
const response = await client.users.getMe({
  userFields: ["pinned_tweet_id"],
  expansions: ["pinned_tweet_id"],
  tweetFields: ["created_at", "text"],
});

console.log(`Username: ${response.data?.username}`);
// La Publication épinglée est disponible dans response.includes?.tweets

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 :

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

Vue d’ensemble

Publications

Utilisateurs

Messages privés

Mentions J’aime

Listes

Espaces

Communautés

Notes de la communauté

Tendances

Actualités

Médias

Activité sur X

Utilisation

Connexions de flux

Conformité

Enterprise v2

Flux des J’aime

GNIP 2.0

Démarrage rapide : utilisateur authentifié

Récupérer l’utilisateur authentifié

Réponse

Cas d’utilisation

Inclure la Publication épinglée

Réponse avec expansions

Champs disponibles

Conditions d’authentification

Prochaines étapes

Recherche d’utilisateurs

Guide d’intégration

Référence de l’API