> ## Documentation Index
> Fetch the complete documentation index at: https://x-preview-mintlify-d5730eee.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.
# Faça sua primeira solicitação
> Faça sua primeira solicitação à X Enterprise API, incluindo configuração de autenticação, seleção de endpoint, comandos cURL de exemplo e dicas para tratamento de respostas.
export const Button = ({href, children}) => {
return ;
};
Este guia orienta você a fazer sua primeira solicitação à X API. Você precisará de uma [conta de desenvolvedor com credenciais de app](/x-api/getting-started/getting-access) antes de começar.
***
## Início rápido com cURL
A maneira mais rápida de testar a API é com cURL. Vamos consultar um usuário:
```bash theme={null}
curl "https://api.x.com/2/users/by/username/xdevelopers" \
-H "Authorization: Bearer $BEARER_TOKEN"
```
Substitua `$BEARER_TOKEN` pelo seu Bearer Token real. Você receberá uma resposta como esta:
```json theme={null}
{
"data": {
"id": "2244994945",
"name": "X Developers",
"username": "xdevelopers"
}
}
```
***
## Guia passo a passo
No [Developer Console](https://console.x.com), navegue até o seu app e copie o Bearer Token.
Comece com um destes endpoints amigáveis para iniciantes:
| Endpoint | O que faz |
| :------------------------------------------------ | :--------------------------------------------- |
| [User lookup](/x-api/users/lookup/introduction) | Obtenha o perfil de usuário por username ou ID |
| [Post lookup](/x-api/posts/lookup/introduction) | Obtenha um post por ID |
| [Recent search](/x-api/posts/search/introduction) | Pesquise posts dos últimos 7 dias |
Use cURL, Postman ou seu cliente HTTP preferido:
```bash theme={null}
# Look up a user by username
curl "https://api.x.com/2/users/by/username/xdevelopers" \
-H "Authorization: Bearer $BEARER_TOKEN"
```
As respostas são em JSON. Os dados principais ficam no campo `data`:
```json theme={null}
{
"data": {
"id": "2244994945",
"name": "X Developers",
"username": "xdevelopers"
}
}
```
***
## Solicite mais dados com fields
Por padrão, os endpoints retornam campos mínimos. Use o parâmetro `fields` para solicitar dados adicionais:
```bash theme={null}
curl "https://api.x.com/2/users/by/username/xdevelopers?user.fields=created_at,description,public_metrics" \
-H "Authorization: Bearer $BEARER_TOKEN"
```
Resposta:
```json theme={null}
{
"data": {
"id": "2244994945",
"name": "X Developers",
"username": "xdevelopers",
"created_at": "2013-12-14T04:35:55.000Z",
"description": "The voice of the X Developer Platform",
"public_metrics": {
"followers_count": 570842,
"following_count": 2048,
"tweet_count": 14052,
"listed_count": 1672
}
}
}
```
[Saiba mais sobre fields →](/x-api/fundamentals/fields)
***
## Mais exemplos
```bash theme={null}
curl "https://api.x.com/2/tweets/1460323737035677698?tweet.fields=created_at,public_metrics" \
-H "Authorization: Bearer $BEARER_TOKEN"
```
```bash theme={null}
curl "https://api.x.com/2/tweets/search/recent?query=from:xdevelopers&tweet.fields=created_at" \
-H "Authorization: Bearer $BEARER_TOKEN"
```
```bash theme={null}
curl "https://api.x.com/2/users/2244994945/tweets?max_results=5" \
-H "Authorization: Bearer $BEARER_TOKEN"
```
***
## Usando código em vez de cURL
```python theme={null}
import requests
bearer_token = "YOUR_BEARER_TOKEN"
url = "https://api.x.com/2/users/by/username/xdevelopers"
headers = {"Authorization": f"Bearer {bearer_token}"}
response = requests.get(url, headers=headers)
print(response.json())
```
```javascript theme={null}
const bearerToken = "YOUR_BEARER_TOKEN";
const url = "https://api.x.com/2/users/by/username/xdevelopers";
fetch(url, {
headers: { Authorization: `Bearer ${bearerToken}` }
})
.then(res => res.json())
.then(data => console.log(data));
```
Para uso em produção, recomendamos os SDKs oficiais:
* [Python SDK](/xdks/python/overview)
* [TypeScript SDK](/xdks/typescript/overview)
Eles cuidam de autenticação, paginação e limites de taxa automaticamente.
***
## Ferramentas para testes
Teste visual da API com a nossa coleção.
Exemplos em múltiplas linguagens.
Documentação completa de endpoints.
***
## Solução de problemas
* Verifique se o seu Bearer Token está correto
* Garanta que o token não foi regenerado
* Verifique o formato do cabeçalho `Authorization`: `Bearer YOUR_TOKEN`
* Seu app pode não ter acesso a este endpoint
* Alguns endpoints exigem autenticação user-context (OAuth 1.0a ou 2.0)
* Verifique as permissões do seu app no Developer Console
* Você atingiu um limite de taxa
* Verifique o cabeçalho `x-rate-limit-reset` para saber quando tentar novamente
* Implemente exponential backoff no seu código
[Referência completa de erros →](/x-api/fundamentals/response-codes-and-errors)
***
## Próximas etapas
Entenda o OAuth para solicitações user-context.
Descubra o que você pode construir.
Desenvolvimento mais rápido com bibliotecas oficiais.
Ideias para o que criar.