Autenticação
Cada site tem chaves secretas sk_ para o servidor e publicáveis pk_ para o navegador, mostradas uma única vez.
Toda requisição leva uma chave do site no cabeçalho Authorization:
GET /public/v1/sites/7c0e…/posts HTTP/1.1
Authorization: Bearer sk_...Sem chave, com chave inválida ou revogada, a API responde 401:
{ "statusCode": 401, "code": "UNAUTHENTICATED" }Dois tipos de chave
| Tipo | Prefixo | Onde usar | Restrição |
|---|---|---|---|
| Secreta | sk_ | Só no servidor: server components, route handlers, build. | Recusada com 403 SECRET_KEY_IN_BROWSER se a requisição vier de um navegador (com Origin), a não ser que o site libere. |
| Publicável | pk_ | Código do navegador. | Só funciona em páginas dos domínios permitidos do site; sem origem, 403 ORIGIN_NOT_ALLOWED. Limite de requisições menor, por chave e IP. |
O caminho recomendado é a chave secreta no servidor do blog, na rota por site, que fica guardada na borda do Cloudflare. A publicável existe para quem precisa chamar a API do navegador.
Chaves pst_ criadas antes dos dois tipos continuam funcionando, como secretas.
Gerar uma chave
No painel, em API pública, com o site escolhido no topo: dê um nome, escolha o tipo e clique para gerar. A mesma tela mostra o id do site (siteId), usado na rota por site.
Cada site pode ter até 5 chaves ativas de cada tipo. A lista mostra o nome, o tipo, o começo da chave, quando foi criada e o último uso.
Trocar uma chave sem queda
- Clique em Rotacionar: o Postream gera uma chave nova do mesmo tipo e nome. A antiga continua valendo por 24 horas (o painel mostra até quando).
- Troque no blog e faça o deploy dentro desse prazo.
Para uma chave vazada, use Revogar: vale na hora, e a chave passa a responder 401.
Alertas de uso
O painel avisa, com a origem e quantas vezes aconteceu, quando:
- uma chave secreta chega com
Originde navegador: provavelmente está no código do site. Rotacione e passe a chamada para o servidor; - uma chave publicável é usada fora dos domínios permitidos.