> ## 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.

# Boas práticas

> Recomendações para integrações em produção com a v0x API

## Segurança

* Nunca exponha `v0x_live_...` em frontend ou mobile
* Use variáveis de ambiente ou secret manager
* Rotacione chaves após incidentes ou offboarding
* Revogue chaves não utilizadas no dashboard

## Upload

* Valide tamanho no cliente antes de enviar (máx. 100 MB)
* Trate `storage_limit_exceeded` com mensagem clara ao usuário
* Use `multipart/form-data` com campo `file`

## Rate limits

* Respeite 60 uploads/min e 120 listagens/min
* Implemente backoff em `429` e `5xx`
* Não faça polling agressivo em `/files`

## Links CDN

* Trate URLs como permanentes para o ciclo de vida do arquivo
* Após `DELETE /files/{id}`, o link deixa de funcionar
* Não indexe links em buscadores se o conteúdo for privado

## Monitoramento

* Logue códigos `error` das respostas
* Monitore uso de storage no dashboard
* Teste health periodicamente: `GET /health`

Veja também: [Erros](/api-reference/guides/errors) · [Rate limiting](/api-reference/rate-limiting)