Ejemplo con Next.js
Un blog en el App Router que lista y muestra los posts de Postream, con ISR, SEO y redirect de slug antiguo.
Este ejemplo usa fetch directo, para mostrar lo que pasa. Para metadata, hreflang, JSON-LD, sitemaps y RSS listos, usa el kit de SEO, que trae el mismo cliente.
Variables de entorno
Solo en el servidor, sin el prefijo NEXT_PUBLIC_. La clave es la secreta (sk_); el id del sitio aparece en el panel, en API pública.
POSTREAM_API_URL=https://api.postream.blog/public/v1
POSTREAM_SITE_ID=7c0e...
POSTREAM_API_KEY=sk_...Cliente
Con el siteId en la URL, las llamadas van a la ruta por sitio: el borde de Cloudflare responde la mayor parte y Postream lo purga cuando el post cambia. La query va en la forma canónica (locale antes de tag, sin page=1), la misma URL que se purga.
const BASE = `${process.env.POSTREAM_API_URL}/sites/${process.env.POSTREAM_SITE_ID}`;
async function postream<T>(path: string): Promise<T | null> {
const res = await fetch(`${BASE}${path}`, {
headers: { Authorization: `Bearer ${process.env.POSTREAM_API_KEY}` },
// Revalida cada 5 minutos (ISR) o al instante, por la tag, cuando llega un webhook.
next: { revalidate: 300, tags: ["postream"] },
});
if (res.status === 404) return null;
if (!res.ok) throw new Error(`Postream ${res.status} ${(await res.json()).code}`);
return res.json() as Promise<T>;
}
export type PostSummary = {
id: string;
locale: string;
slug: string;
title: string;
excerpt: string;
tags: string[];
seo: { metaTitle: string; metaDescription: string; og: { title: string; description: string; type: string } };
translations: { locale: string; slug: string; title: string }[];
author: { name: string } | null;
publishedAt: string;
updatedAt: string;
};
export type Post = PostSummary & { bodyHtml: string; bodyMarkdown: string };
export const listPosts = (locale: string, page = 1) =>
postream<{ data: PostSummary[]; pagination: { page: number; perPage: number; total: number; totalPages: number } }>(
`/posts?locale=${encodeURIComponent(locale)}${page > 1 ? `&page=${page}` : ""}`,
);
export const getPost = (slug: string, locale: string) =>
postream<{ data: Post }>(`/posts/${encodeURIComponent(slug)}?locale=${encodeURIComponent(locale)}`).then((r) => r?.data ?? null);Página del post
import type { Metadata } from "next";
import { notFound, permanentRedirect } from "next/navigation";
import { getPost } from "@/lib/postream";
type Props = { params: Promise<{ slug: string }> };
export async function generateMetadata({ params }: Props): Promise<Metadata> {
const post = await getPost((await params).slug, "es");
if (!post) return {};
// Slug antiguo: la página hace el redirect; los metadatos apuntan a la URL nueva.
return {
title: post.seo.metaTitle,
description: post.seo.metaDescription,
alternates: { canonical: `/blog/${post.slug}` },
openGraph: { title: post.seo.og.title, description: post.seo.og.description, type: "article", publishedTime: post.publishedAt },
};
}
export default async function BlogPost({ params }: Props) {
const { slug } = await params;
const post = await getPost(slug, "es");
if (!post) notFound();
// La API siguió el 301 de un slug antiguo: envía al visitante a la URL nueva
// (308, que Google trata como el 301).
if (post.slug !== slug) permanentRedirect(`/blog/${post.slug}`);
return (
<article>
<h1>{post.title}</h1>
<div dangerouslySetInnerHTML={{ __html: post.bodyHtml }} />
</article>
);
}Lista
import Link from "next/link";
import { listPosts } from "@/lib/postream";
export default async function Blog() {
const result = await listPosts("es");
return (
<ul>
{result?.data.map((post) => (
<li key={post.id}>
<Link href={`/blog/${post.slug}`}>{post.title}</Link>
</li>
))}
</ul>
);
}hreflang de las traducciones
translations trae las otras versiones publicadas del mismo post. Úsalo en alternates.languages:
alternates: {
canonical: `/blog/${post.slug}`,
languages: Object.fromEntries(post.translations.map((t) => [t.locale, `/${t.locale}/blog/${t.slug}`])),
},