Schema AvatarDecoration: molduras animadas de perfil

Documentação do schema AvatarDecoration da API Ghosting. Saiba como funcionam as molduras animadas de avatar, hospedadas na CDN Cloudflare R2.

O schema AvatarDecoration representa uma moldura animada que pode ser aplicada ao avatar de um perfil Ghosting. Nem todos os perfis possuem uma decoração: quando não houver, o campo avatarDecoration no schema User será null. As imagens das decorações são hospedadas em uma CDN Cloudflare R2, garantindo baixa latência e alta disponibilidade global.

Campos do schema AvatarDecoration

id · string | null · required

Identificador único da decoração (ex: "spirit_embers"). null quando não há decoração.

name · string | null · required

Nome de exibição da decoração (ex: "Spirit Embers"). null quando não há decoração.

file · string | null · required

Nome do arquivo da imagem da decoração (ex: "spirit_embers.png"). null quando não há decoração.

url · string (URL) | null · required

URL direta para o arquivo da decoração na CDN Cloudflare R2. null quando não há decoração.

Exemplo JSON

{
  "avatarDecoration": {
    "id": "spirit_embers",
    "name": "Spirit Embers",
    "file": "spirit_embers.png",
    "url": "https://ghosting.fun/api/decoration?f=spirit_embers.png"
  }
}

Perfil sem decoração

Quando um perfil não possui moldura animada, o campo avatarDecoration é null:

{
  "avatarDecoration": null
}

Use a URL do campo url diretamente em tags <img> ou componentes de imagem da sua aplicação. A CDN Cloudflare R2 entrega as decorações com cache otimizado.

O campo file é útil quando você precisa construir URLs alternativas ou referenciar o recurso em sistemas que trabalham com nomes de arquivo em vez de URLs completas.

Leia mais

Schema User

Veja como o campo avatarDecoration está aninhado no schema User completo.

Schema Badges

Conheça os selos de verificação que complementam a identidade visual do perfil.