Postream

Cargando el índice…

Documentación: Ejemplo con Next.js

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.

.env
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.

lib/postream.ts
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

app/blog/[slug]/page.tsx
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

app/blog/page.tsx
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}`])),
},