Skip to main content
O schema BanInfo contém as informações de moderação de um perfil Ghosting. Diferentemente de muitas APIs, perfis suspensos retornam HTTP 200 OK (não 404 ou 403), com data.status: "suspended" e data.banInfo.isBanned: true. Essa arquitetura evita exceções HTTP que poderiam quebrar bots de Discord e outras integrações automatizadas, além de permitir auditoria transparente do motivo da suspensão.

Campos do schema BanInfo

boolean
required
Indica se o perfil está suspensa. true para suspensos, false para perfis ativos.
string | null
required
Motivo interno da suspensão, ou null se o perfil não estiver suspenso.
string | null
required
Mensagem formatada para exibição pública sobre a suspensão, ou null se não houver.
string (ISO 8601) | null
required
Data e hora da suspensão no formato ISO 8601, ou null se o perfil não estiver suspenso.

Exemplo JSON: perfil suspenso

Perfis suspensos sempre retornam HTTP 200 OK. Sua aplicação deve verificar data.status e data.banInfo.isBanned para identificar contas suspensas, em vez de confiar apenas no status HTTP.

Leia mais

Guia de Moderação

Entenda a arquitetura de moderação e como lidar com perfis suspensos em integrações.

Schema User

Veja o objeto User completo, onde o campo banInfo está aninhado.