Exemplo com Next.js
Um blog no App Router que lista e mostra os posts do Postream, com ISR, SEO e redirect de slug antigo.
Este exemplo usa fetch direto, para mostrar o que acontece. Para metadata, hreflang, JSON-LD, sitemaps e RSS prontos, use o kit de SEO, que traz o mesmo cliente.
Variáveis de ambiente
Só no servidor, sem o prefixo NEXT_PUBLIC_. A chave é a secreta (sk_); o id do site aparece no painel, em API pública.
POSTREAM_API_URL=https://api.postream.blog/public/v1
POSTREAM_SITE_ID=7c0e...
POSTREAM_API_KEY=sk_...Cliente
Com o siteId na URL, as chamadas vão para a rota por site: a borda do Cloudflare responde a maior parte delas e o Postream a purga quando o post muda. A query vai na forma canônica (locale antes de tag, sem page=1), a mesma URL que é purgada.
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 a cada 5 minutos (ISR) ou na hora, pela tag, quando chega um 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 do 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, "pt-BR");
if (!post) return {};
// Slug antigo: a página faz o redirect; os metadados apontam para a URL nova.
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, "pt-BR");
if (!post) notFound();
// A API seguiu o 301 de um slug antigo: manda o visitante para a URL nova
// (308, que o Google trata como o 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("pt-BR");
return (
<ul>
{result?.data.map((post) => (
<li key={post.id}>
<Link href={`/blog/${post.slug}`}>{post.title}</Link>
</li>
))}
</ul>
);
}hreflang das traduções
translations traz as outras versões publicadas do mesmo post. Use em alternates.languages:
alternates: {
canonical: `/blog/${post.slug}`,
languages: Object.fromEntries(post.translations.map((t) => [t.locale, `/${t.locale}/blog/${t.slug}`])),
},