Schema BanInfo: status de moderação do perfil

Documentação do schema BanInfo da API Ghosting. Entenda como a API retorna informações de suspensão via HTTP 200 OK para evitar quebras em bots e integrações.

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

isBanned · boolean · required

Indica se o perfil está suspensa. true para suspensos, false para perfis ativos.

reason · string | null · required

Motivo interno da suspensão, ou null se o perfil não estiver suspenso.

message · string | null · required

Mensagem formatada para exibição pública sobre a suspensão, ou null se não houver.

bannedAt · 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

{
  "success": true,
  "data": {
    "username": "usuario_exemplo",
    "displayName": "Usuário Exemplo",
    "bio": "",
    "avatarUrl": "https://ghosting.fun/api/avatar?u=usuario_exemplo",
    "pageUrl": "https://ghosting.fun/p/usuario_exemplo",
    "hasCustomDomain": false,
    "customDomain": null,
    "accountAgeDays": 30,
    "createdAt": "2026-08-07T10:00:00.000Z",
    "views": 150,
    "badges": {
      "isVerified": false,
      "isOfficial": false,
      "isHelper": false,
      "list": []
    },
    "avatarDecoration": null,
    "socials": [],
    "status": "suspended",
    "banInfo": {
      "isBanned": true,
      "reason": "Violação dos termos de serviço",
      "message": "Este perfil foi suspenso por violação dos termos de serviço.",
      "bannedAt": "2026-09-01T14:30:00.000Z"
    }
  },
  "meta": {
    "timestamp": "2026-09-06T18:00:00.000Z",
    "version": "v1",
    "executionTimeMs": 5
  }
}

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.