Guia de integração

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.

Autenticação

Os endpoints de blocks exigem autenticação do usuário:

Método	Descrição
OAuth 2.0 Authorization Code with PKCE	Recomendado para novas aplicações
OAuth 1.0a User Context	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

{
  "data": [
    {
      "id": "1234567890",
      "name": "Example User",
      "username": "example"
    }
  ]
}

Fields disponíveis

user.fields

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

expansions

Expansion	Descrição
`pinned_tweet_id`	Post fixado do usuário

O que acontece quando você bloqueia

Eles não podem

Ver seus Posts (a menos que estejam deslogados)
Seguir você
Enviar DMs para você
Adicionar você a Lists
Marcar você em fotos

Você não pode

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:

cURL

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

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

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
404	Não encontrado	O usuário não existe
429	Muitas requisições	Aguarde e tente novamente

Próximos passos

Guia rápido

Faça sua primeira requisição de blocks

Mutes

Silencie usuários em vez de bloqueá-los

Referência da API

Documentação completa do endpoint

Código de exemplo

Exemplos de código funcionais

Getting Started

Products

Fundamentals

Partners & Customers

Resources

Guia de integração

Autenticação

Escopos obrigatórios (OAuth 2.0)

Visão geral dos endpoints

Fields e expansions

Resposta padrão

Fields disponíveis

O que acontece quando você bloqueia

Eles não podem

Você não pode

Paginação

Tratamento de erros

Próximos passos

Guia rápido

Mutes

Referência da API

Código de exemplo

​Autenticação

​Escopos obrigatórios (OAuth 2.0)

​Visão geral dos endpoints

​Fields e expansions

​Resposta padrão

​Fields disponíveis

​O que acontece quando você bloqueia

Eles não podem

Você não pode

​Paginação

​Tratamento de erros

​Próximos passos

Guia rápido

Mutes

Referência da API

Código de exemplo

Autenticação

Escopos obrigatórios (OAuth 2.0)

Visão geral dos endpoints

Fields e expansions

Resposta padrão

Fields disponíveis

O que acontece quando você bloqueia

Paginação

Tratamento de erros

Próximos passos