Skip to main content
Comece a usar a X API em três passos: cadastre-se, crie um app e salve suas credenciais.

Passo 1: crie uma developer account

1

Acesse o Developer Console

Visite console.x.com e faça login com sua conta do X.
2

Aceite o Developer Agreement

Revise e aceite o Developer Agreement e a Policy.
3

Complete seu perfil

Forneça informações básicas sobre como você usará a API.

Passo 2: crie um app

Após o cadastro, crie um app para obter suas credenciais de API:
1

Clique em 'New App'

No painel do Developer Console, crie um novo app.
2

Informe os detalhes do app

Forneça um nome, uma descrição e o caso de uso do seu app.
3

Gere as credenciais

O console gerará suas API keys e tokens.

Passo 3: salve suas credenciais

Você receberá diferentes credenciais dependendo das suas necessidades de autenticação:
CredencialFinalidade
API Key e SecretIdentificam seu app. Usadas para gerar tokens e assinar solicitações OAuth 1.0a.
Bearer TokenAutenticação app-only para leitura de dados públicos.
Access Token e SecretFazer solicitações em nome da sua própria conta (OAuth 1.0a).
Client ID e SecretAutenticação OAuth 2.0 para solicitações com contexto de usuário.
Salve imediatamente. As credenciais são exibidas apenas uma vez. Armazene-as em um gerenciador de senhas ou cofre seguro. Se você as perder, precisará regenerá-las (o que invalida as antigas).

De quais credenciais você precisa?

Use o Bearer Token para acesso simples e somente leitura a dados públicos.
curl "https://api.x.com/2/users/by/username/xdevelopers" \
  -H "Authorization: Bearer $BEARER_TOKEN"
Ideal para: pesquisar posts, consultar usuários, ler tendências.

Boas práticas de segurança para credenciais

Use variáveis de ambiente

Nunca deixe credenciais hardcoded no seu código-fonte.

Não envie para o git

Adicione arquivos de credenciais ao .gitignore.

Faça rotação regularmente

Regenere as credenciais periodicamente como medida de segurança.

Use escopos mínimos

Solicite apenas as permissões OAuth de que seu app precisa.

Próximos passos

Faça sua primeira solicitação

Chame a API com suas novas credenciais.

Aprenda sobre autenticação

Entenda OAuth 1.0a e OAuth 2.0.