Guia rápido do usuário autenticado

Este guia mostra como recuperar o perfil do usuário atualmente autenticado usando o endpoint /me.

Pré-requisitosAntes de começar, você precisará de:

Uma conta de desenvolvedor com um App aprovado
User Access Token (OAuth 1.0a ou OAuth 2.0 PKCE)

Obter o usuário autenticado

Faça uma requisição ao endpoint /me com um User Access Token:

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")

# Obter o usuário autenticado
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" });

// Obter o usuário autenticado
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}`);

Resposta

Exemplo de resposta

{
  "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
    }
  }
}

Caso de uso

O endpoint /me é essencial ao:

Verificar a autenticação — Confirme se o usuário está autenticado corretamente
Obter o user ID — Recupere o ID do usuário autenticado para outras chamadas à API
Personalizar experiências — Exiba o perfil do usuário no seu app
Requisições em nome de — Saiba em nome de quem você está fazendo as requisições

Incluir o Post fixado

Solicite o Post fixado do usuário:

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")

# Obter usuário autenticado com o Post fixado
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}")
# O Post fixado está em response.includes.tweets

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

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

// Obter usuário autenticado com o Post fixado
const response = await client.users.getMe({
  userFields: ["pinned_tweet_id"],
  expansions: ["pinned_tweet_id"],
  tweetFields: ["created_at", "text"],
});

console.log(`Username: ${response.data?.username}`);
// O Post fixado está em response.includes?.tweets

Resposta com expansion

Exemplo de resposta

{
  "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"
      }
    ]
  }
}

Fields disponíveis

Field	Descrição
`created_at`	Data de criação da conta
`description`	Bio do usuário
`profile_image_url`	URL do avatar
`verified`	Status de verificação
`public_metrics`	Contagens de seguidores/seguindo
`location`	Localização definida pelo usuário
`url`	Site do usuário
`protected`	Status de conta protegida
`pinned_tweet_id`	ID do Post fixado

Requisito de autenticação

O endpoint /me exige autenticação User Context. Autenticação App-Only (Bearer Token) não é suportada.

Use um destes:

Próximos passos

Consulta de usuário

Consulte outros usuários

Guia de integração

Conceitos-chave e melhores práticas

Referência da API

Documentação completa do endpoint

Getting Started

Products

Fundamentals

Partners & Customers

Resources

Guia rápido do usuário autenticado

Obter o usuário autenticado

Resposta

Caso de uso

Incluir o Post fixado

Resposta com expansion

Fields disponíveis

Requisito de autenticação

Próximos passos

Consulta de usuário

Guia de integração

Referência da API

​Obter o usuário autenticado

​Resposta

​Caso de uso

​Incluir o Post fixado

​Resposta com expansion

​Fields disponíveis

​Requisito de autenticação

​Próximos passos

Consulta de usuário

Guia de integração

Referência da API

Obter o usuário autenticado

Resposta

Caso de uso

Incluir o Post fixado

Resposta com expansion

Fields disponíveis

Requisito de autenticação

Próximos passos