Autenticación
Cada sitio tiene claves secretas sk_ para el servidor y publicables pk_ para el navegador, mostradas una sola vez.
Toda solicitud lleva una clave del sitio en el encabezado Authorization:
GET /public/v1/sites/7c0e…/posts HTTP/1.1
Authorization: Bearer sk_...Sin clave, o con una clave inválida o revocada, la API responde 401:
{ "statusCode": 401, "code": "UNAUTHENTICATED" }Dos tipos de clave
| Tipo | Prefijo | Dónde usarla | Restricción |
|---|---|---|---|
| Secreta | sk_ | Solo en el servidor: server components, route handlers, build. | Se rechaza con 403 SECRET_KEY_IN_BROWSER si la solicitud viene de un navegador (con Origin), salvo que el sitio lo permita. |
| Publicable | pk_ | Código del navegador. | Solo funciona en páginas de los dominios permitidos del sitio; sin origen, 403 ORIGIN_NOT_ALLOWED. Límite de solicitudes menor, por clave e IP. |
El camino recomendado es la clave secreta en el servidor del blog, en la ruta por sitio, que queda guardada en el borde de Cloudflare. La publicable existe para quien necesita llamar a la API desde el navegador.
Las claves pst_ creadas antes de los dos tipos siguen funcionando, como secretas.
Generar una clave
En el panel, en API pública, con el sitio elegido arriba: ponle un nombre, elige el tipo y haz clic para generarla. La misma pantalla muestra el id del sitio (siteId), que usa la ruta por sitio.
Cada sitio puede tener hasta 5 claves activas de cada tipo. La lista muestra el nombre, el tipo, el comienzo de la clave, cuándo se creó y el último uso.
Cambiar una clave sin caída
- Haz clic en Rotar: Postream genera una clave nueva del mismo tipo y nombre. La anterior sigue valiendo 24 horas (el panel muestra hasta cuándo).
- Cámbiala en el blog y haz el deploy dentro de ese plazo.
Para una clave filtrada, usa Revocar: vale al instante, y la clave pasa a responder 401.
Alertas de uso
El panel avisa, con el origen y cuántas veces pasó, cuando:
- una clave secreta llega con
Originde navegador: probablemente está en el código del sitio. Rótala y pasa la llamada al servidor; - una clave publicable se usa fuera de los dominios permitidos.