> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ghosting.fun/llms.txt
> Use this file to discover all available pages before exploring further.

# Schema Socials: links de redes sociais do perfil

> Documentação do schema Socials da API Ghosting. Conheça as plataformas suportadas e a estrutura dos links de redes sociais vinculados a um perfil.

O schema `Socials` descreve os links de redes sociais vinculados a um perfil Ghosting. Cada item do array contém a plataforma, a URL pública e, opcionalmente, a URL de um ícone. Esses links são exibidos na página pública do perfil e podem ser consumidos por bots, dashboards e outras integrações para enriquecer a apresentação de um usuário.

## Estrutura de um item Socials

<ResponseField name="platform" type="string" required>
  Nome da plataforma de rede social. Valores suportados: `discord`, `github`, `steam`, `twitter`, `instagram`, `youtube`.
</ResponseField>

<ResponseField name="url" type="string (URL)" required>
  URL pública do perfil na respectiva plataforma.
</ResponseField>

<ResponseField name="iconUrl" type="string (URL) | undefined">
  URL opcional para um ícone customizado da plataforma. Quando ausente, a interface deve usar um ícone padrão baseado no nome da plataforma.
</ResponseField>

## Plataformas suportadas

| Plataforma  | Exemplo de URL                           |
| ----------- | ---------------------------------------- |
| `discord`   | `https://discord.gg/vkWVxrd9Bn`          |
| `github`    | `https://github.com/ihyos/PAYLINK`       |
| `steam`     | `https://steamcommunity.com/id/ghosting` |
| `twitter`   | `https://twitter.com/usuario`            |
| `instagram` | `https://instagram.com/usuario`          |
| `youtube`   | `https://youtube.com/@usuario`           |

## Exemplo JSON

```json theme={null}
{
  "socials": [
    {
      "platform": "discord",
      "url": "https://discord.gg/vkWVxrd9Bn"
    },
    {
      "platform": "github",
      "url": "https://github.com/ihyos/PAYLINK"
    },
    {
      "platform": "steam",
      "url": "https://steamcommunity.com/id/ghosting"
    }
  ]
}
```

<Tip>
  Quando `iconUrl` não estiver presente, use o nome da plataforma para mapear ícones padrão da sua biblioteca de UI (como FontAwesome, Tabler ou Heroicons).
</Tip>

<Info>
  A ordem dos itens no array `socials` respeita a ordem definida pelo usuário no painel do Ghosting. Mantenha essa ordem ao renderizar para preservar a preferência do perfil.
</Info>

## Leia mais

<CardGroup cols={2}>
  <Card title="Schema User" href="/schemas/user">
    Veja como o array `socials` está aninhado no schema User completo.
  </Card>

  <Card title="Schema Badges" href="/schemas/badges">
    Conheça os selos de verificação que complementam a identidade pública do perfil.
  </Card>
</CardGroup>