Postream

Cargando el índice…

Documentación: Dominios permitidos y CORS

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.com
  • blog.ejemplo.com vale solo para ese host; *.ejemplo.com, para cualquier subdominio (no para el propio ejemplo.com, que necesita su propia línea).
  • Siempre https, en el puerto estándar. Sin ruta ni esquema.
  • localhost, 127.0.0.1 y [::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-Origin para los orígenes de los dominios permitidos.
  • El preflight (OPTIONS) no lleva clave, así que responde a cualquier origen; quien decide es el GET.
  • Encabezados aceptados: Authorization e If-None-Match.
  • Encabezados expuestos a JavaScript: ETag, RateLimit-Limit, RateLimit-Remaining, RateLimit-Reset y Retry-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.