> ## Documentation Index
> Fetch the complete documentation index at: https://docs.x.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Guia de integração
> Este guia cobre os principais conceitos necessários para integrar os endpoints de blocks ao seu. Referência para o nível standard da X API v2 sobre blocks.
export const Button = ({href, children}) => {
return ;
};
Este guia cobre os principais conceitos necessários para integrar os endpoints de blocks à sua aplicação.
Os endpoints de bloquear e desbloquear usuários só estão disponíveis no plano Enterprise. Você pode preencher o formulário de interesse Enterprise [aqui](/forms/enterprise-api-interest).
***
## Autenticação
Os endpoints de blocks exigem autenticação do usuário:
| Método | Descrição |
| :----------------------------------------------------------------------------------------------------------------------------- | :-------------------------------- |
| [OAuth 2.0 Authorization Code with PKCE](/resources/fundamentals/authentication#oauth-2-0-authorization-code-flow-with-pkce-2) | Recomendado para novas aplicações |
| [OAuth 1.0a User Context](/resources/fundamentals/authentication) | Suporte legado |
A autenticação App-Only não é suportada. Você deve autenticar em nome de um usuário.
### Escopos obrigatórios (OAuth 2.0)
| Escopo | Necessário para |
| :------------ | :--------------------------------------- |
| `block.read` | Obter contas bloqueadas |
| `block.write` | Bloquear e desbloquear contas |
| `users.read` | Necessário junto com os escopos de block |
***
## Visão geral dos endpoints
| Método | Endpoint | Descrição | Disponibilidade |
| :----- | :-------------------------------------------------- | :--------------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| GET | `/2/users/:id/blocking` | Obter a lista de contas bloqueadas | Pay-per-useEnterprise
|
| POST | `/2/users/:id/blocking` | Bloquear uma conta | Enterprise |
| DELETE | `/2/users/:source_user_id/blocking/:target_user_id` | Desbloquear uma conta | Enterprise |
***
## Fields e expansions
### Resposta padrão
```json theme={null}
{
"data": [
{
"id": "1234567890",
"name": "Example User",
"username": "example"
}
]
}
```
### 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 |
| `public_metrics` | Contagem de seguidores/seguindo |
| `verified` | Status de verificação |
| Expansion | Descrição |
| :---------------- | :--------------------- |
| `pinned_tweet_id` | Post fixado do usuário |
***
## O que acontece quando você bloqueia
* Ver seus Posts (a menos que estejam deslogados)
* Seguir você
* Enviar DMs para você
* Adicionar você a Lists
* Marcar você em fotos
* Ver os Posts deles
* Seguir eles
* Enviar DMs para eles
Quando você bloqueia alguém que segue você, essa pessoa deixa de seguir você automaticamente.
***
## Paginação
Para usuários com listas grandes de bloqueios, os resultados são paginados:
```bash cURL theme={null}
# Primeira requisição
curl "https://api.x.com/2/users/123/blocking?max_results=100" \
-H "Authorization: Bearer $USER_ACCESS_TOKEN"
# Requisição subsequente com token de paginação
curl "https://api.x.com/2/users/123/blocking?max_results=100&pagination_token=NEXT_TOKEN" \
-H "Authorization: Bearer $USER_ACCESS_TOKEN"
```
```python title="Python SDK" lines wrap icon="python" theme={null}
from xdk import Client
# Use um user access token do OAuth 2.0
client = Client(bearer_token="YOUR_USER_ACCESS_TOKEN")
# O SDK trata a paginação automaticamente
all_blocked = []
for page in client.users.get_blocking(user_id="123", max_results=100):
if page.data:
all_blocked.extend(page.data)
print(f"Blocked {len(all_blocked)} users")
```
```javascript title="JavaScript SDK" lines wrap icon="square-js" theme={null}
import { Client } from "@xdevplatform/xdk";
const client = new Client({ accessToken: "YOUR_USER_ACCESS_TOKEN" });
async function getAllBlockedUsers(userId) {
const allBlocked = [];
// O SDK trata a paginação automaticamente
const paginator = client.users.getBlocking(userId, { maxResults: 100 });
for await (const page of paginator) {
if (page.data) {
allBlocked.push(...page.data);
}
}
return allBlocked;
}
// Uso
const blocked = await getAllBlockedUsers("123");
console.log(`Blocked ${blocked.length} users`);
```
***
## Tratamento de erros
| Status | Erro | Solução |
| :----- | :------------------ | :--------------------------------------------------------------------------------------------------------- |
| 400 | Requisição inválida | Verifique o formato do user ID |
| 401 | Não autorizado | Verifique o access token |
| 403 | Proibido | Verifique escopos e permissões. Bloquear/desbloquear requerem [Enterprise](/forms/enterprise-api-interest) |
| 404 | Não encontrado | O usuário não existe |
| 429 | Muitas requisições | Aguarde e tente novamente |
***
## Próximos passos
Faça sua primeira requisição de blocks
Silencie usuários em vez de bloqueá-los
Documentação completa do endpoint
Exemplos de código funcionais