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

# ShareX

> Configurar upload automático com ShareX via v0x API

ShareX envia capturas de tela e arquivos diretamente para a v0x API.

## Pré-requisitos

* [ShareX](https://getsharex.com/) instalado no Windows
* API key criada em [dash.v0x.lol/dashboard/api-keys](https://dash.v0x.lol/dashboard/api-keys)

## Configuração rápida

1. No dashboard, vá em **Integrations** ou baixe o `.sxcu` em [v0x.lol](https://v0x.lol/#sharex)
2. Importe o perfil no ShareX
3. Substitua `YOUR_API_KEY` pela sua chave `v0x_live_...`

## Configuração manual (.sxcu)

```json theme={"theme":{"light":"github-light","dark":"one-dark-pro"}}
{
  "Version": "16.1.0",
  "Name": "v0x",
  "DestinationType": "ImageUploader, FileUploader",
  "RequestMethod": "POST",
  "RequestURL": "https://api.v0x.lol/api/v1/files",
  "Headers": {
    "Authorization": "Bearer v0x_live_SUA_CHAVE"
  },
  "Body": "MultipartFormData",
  "FileFormName": "file",
  "URL": "{json:url}",
  "ThumbnailURL": "{json:url}"
}
```

<Warning>
  O campo `URL` lê `url` da resposta JSON. A API retorna `url` com o link CDN — não `v0x.lol/f/...`.
</Warning>

## Testar

1. Capture uma região com ShareX
2. Verifique se o link copiado abre o arquivo no CDN
3. Confira o arquivo em [dash.v0x.lol/dashboard/files](https://dash.v0x.lol/dashboard/files)

## Troubleshooting

| Problema                     | Solução                               |
| ---------------------------- | ------------------------------------- |
| `401 unauthorized`           | Verifique o Bearer token              |
| `403 storage_limit_exceeded` | Libere espaço ou exclua arquivos      |
| `413 file_too_large`         | Arquivo acima de 100 MB               |
| Link não copiado             | Confirme `URL: "{json:url}"` no .sxcu |

Veja também: [Primeira integração](/pages/guides/primeira-integracao) · [Erros](/api-reference/guides/errors)