Armazenamento de arquivos da Plataforma Keeptor (assets privados e públicos)
Storage
Repositório de arquivos da Plataforma Keeptor. Separa rotas privadas (que exigem autenticação Bearer e respeitam isolamento por organização) das rotas públicas (anônimas, para assets institucionais como o carrossel da tela de login).
Convenções
- Rotas privadas: sob
/v1/storage/...exigemAuthorization: Bearer <access_token>e só enxergam dados da organização do usuário logado. - Rotas públicas: sob
/v1/storage/public/...e/v1/storage/public-bytessão anônimas — qualquer cliente pode consumir sem token. - Schema de resposta: padrão Keeptor —
{ success, data, message?, error? }para listagens; conteúdo binário (image/jpeg, etc.) para/public-bytes. - URLs públicas devolvidas são absolutas e prontas para uso direto em
<img src>/<a href>. A Plataforma Keeptor serve os bytes diretamente — o cliente nunca precisa conhecer detalhes do armazenamento subjacente.
Cache
- Listagens (
/public/login-banners):Cache-Control: public, max-age=60, stale-while-revalidate=300— o cliente reaproveita a resposta por 1 minuto e revalida em background por mais 5 minutos. - Conteúdo binário (
/public-bytes):Cache-Control: public, max-age=3600, stale-while-revalidate=86400— assets ficam fresh por 1 hora no navegador/CDN e podem ser servidos stale por até 24 horas enquanto revalidam.