Dominios permitidos y CORS
Los dominios del blog habilitan la clave publicable en el navegador y deciden el CORS.
Esto solo lo necesita quien llama a la API desde el navegador, con la clave publicable (pk_). Desde el servidor del blog, con la clave secreta (el camino recomendado), nada de esto aplica.
Registrar los dominios
En el panel, en API pública → Dominios permitidos en el navegador, uno por línea:
blog.ejemplo.com
*.ejemplo.comblog.ejemplo.comvale solo para ese host;*.ejemplo.com, para cualquier subdominio (no para el propioejemplo.com, que necesita su propia línea).- Siempre
https, en el puerto estándar. Sin ruta ni esquema. localhost,127.0.0.1y[::1](cualquier puerto, http o https) solo con Permitir localhost marcado, para desarrollo.
La clave publicable solo funciona con Origin (o Referer) en uno de esos dominios. Fuera de ellos, o sin origen, la API responde 403 ORIGIN_NOT_ALLOWED.
Clave secreta en el navegador
Por defecto, una clave secreta que llega con Origin de navegador se rechaza con 403 SECRET_KEY_IN_BROWSER: quien abre la página vería la clave. Aceptar la clave secreta desde el navegador desactiva ese rechazo.
CORS
- Solo existe en la ruta por clave (
/public/v1/posts…). La ruta por sitio no tiene CORS: va a la caché de Cloudflare, y el navegador no lee sus respuestas desde otro origen. - La respuesta solo trae
Access-Control-Allow-Originpara los orígenes de los dominios permitidos. - El preflight (
OPTIONS) no lleva clave, así que responde a cualquier origen; quien decide es elGET. - Encabezados aceptados:
AuthorizationeIf-None-Match. - Encabezados expuestos a JavaScript:
ETag,RateLimit-Limit,RateLimit-Remaining,RateLimit-ResetyRetry-After. - Sin cookies: el CORS de la API pública nunca usa
credentials.
// En una página de blog.ejemplo.com
const res = await fetch("https://api.postream.blog/public/v1/posts?locale=es", {
headers: { Authorization: "Bearer pk_..." },
});El panel "Probar" de esta documentación
Las páginas de endpoint tienen un panel para llamar a la API desde aquí, con una clave publicable. Para que funcione con tu sitio, incluye el dominio de esta documentación en los dominios permitidos, prueba y después quítalo si quieres.