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ámetro | Por defecto | Descripció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 enlacesjavascript: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 entitle).
{
"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" } }Locationes 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"const res = await fetch(`https://api.postream.blog/public/v1/sites/${process.env.POSTREAM_SITE_ID}/posts/${encodeURIComponent(slug)}?locale=es`, {
headers: { Authorization: `Bearer ${process.env.POSTREAM_API_KEY}` },
});
if (res.status === 404) return null;
const { data: post } = await res.json();import { notFound, permanentRedirect } from "next/navigation";
import { getPost } from "@/lib/postream";
export default async function BlogPost({ params }: { params: Promise<{ slug: string }> }) {
const { slug } = await params;
const post = await getPost(slug, "es");
if (!post) notFound();
if (post.slug !== slug) permanentRedirect(`/blog/${post.slug}`);
return <article dangerouslySetInnerHTML={{ __html: post.bodyHtml }} />;
}