Postream

Carregando o índice…

Documentação: Exemplo com Next.js

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.

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

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

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, "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

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