Postream

Cargando el índice…

Documentación: Buscar un post

Buscar un post

Un post publicado por el slug, con el cuerpo en HTML y en Markdown.

GET/public/v1/sites/{siteId}/posts/:slug

GET/public/v1/posts/:slug

La primera es la ruta por sitio (solo clave secreta, guardada en el borde hasta un día y purgada cuando el post cambia); la segunda es la ruta por clave (secreta o publicable). Mira Dos rutas.

Parámetros

ParámetroPor defectoDescripción
slugrutaobligatorio—Slug de la versión del post, como aparece en la lista.
localetexto—Idioma de la versión. Sin él, un slug que exista en más de un idioma se resuelve al idioma principal del sitio.

Respuesta

Los mismos campos de un elemento de la lista, dentro de data, y además:

  • bodyHtml: el cuerpo renderizado. El HTML crudo que viene del Markdown se escapa y los enlaces javascript: se descartan, así que se puede inyectar directo en la página.
  • bodyMarkdown: el cuerpo en Markdown. El título no está en el cuerpo (viene en title).
{
  "data": {
    "id": "7c0e…",
    "locale": "es",
    "slug": "como-gestionar-varios-blogs",
    "title": "Cómo gestionar varios blogs",
    "bodyHtml": "<p>…</p>",
    "bodyMarkdown": "…",
    "…": "los demás campos de la lista"
  }
}

Un slug inexistente, no publicado o de otro sitio responde 404 NOT_FOUND.

Slug antiguo: 301

Cuando alguien cambia en el panel el slug de una versión publicada, el slug anterior sigue apuntando a ella. Pedir el slug antiguo responde 301 Moved Permanently:

HTTP/1.1 301 Moved Permanently
Location: slug-nuevo?locale=es
Cache-Control: private, no-cache
 
{ "redirectTo": { "slug": "slug-nuevo", "locale": "es" } }
  • Location es relativo al propio endpoint (/public/v1/posts/slug-nuevo?locale=es).
  • Todos los slugs antiguos de una versión apuntan directo al actual, sin cadena de redirects.
  • Volver a un slug antiguo hace que vuelva a valer; el que se dejó pasa a redirigir.
  • El slug antiguo sigue reservado: otro post del mismo sitio e idioma no puede usarlo. Otro idioma u otro sitio sí.
  • Sin ?locale=, un slug vigente en cualquier idioma gana sobre un slug antiguo.
  • Si la versión sale del aire (despublicada o eliminada), el slug antiguo responde 404. Eliminar el post libera sus slugs antiguos.
  • Las versiones nunca publicadas no guardan slug antiguo: nadie tenía el enlace.

El fetch sigue el 301 solo (el Authorization va incluido, porque el destino es el mismo origen) y devuelve el post con el slug actual. Por eso el blog solo necesita comparar: si data.slug es distinto del slug de la URL, envía al visitante (y a Google) a la URL nueva con un redirect permanente, como en el ejemplo con Next.js. Quien prefiera no seguirlo puede usar redirect: "manual" en el servidor y leer redirectTo del cuerpo.

Ejemplos

curl -L -H "Authorization: Bearer $POSTREAM_API_KEY" \
  "https://api.postream.blog/public/v1/sites/$POSTREAM_SITE_ID/posts/como-gestionar-varios-blogs?locale=es"