Εικόνες OG στο Next.js Pages Router
Δημιουργήστε εικόνες OG στο Next.js Pages Router με το συνδρομητικό Dynamic API της FastOG — με συνδρομή στο Dynamic API (δημιουργήστε το κλειδί API σας στον πίνακα ελέγχου). Χρησιμοποιήστε το δωρεάν εργαλείο δοκιμής εικόνων OG για να προεπισκοπήσετε οποιοδήποτε πρότυπο και, στη συνέχεια, συνδέστε δυναμικές εικόνες Open Graph με υπογεγραμμένα URL HMAC στις διαδρομές του Pages Router.
Ρύθμιση
1. Δημιουργήστε το βοηθητικό εργαλείο υπογραφής (signer utility)
// lib/og-image-signer.js
import crypto from "crypto";
export function generateSignedOgUrl(params, options = {}) {
const {
baseUrl = "https://fastog.com/api/v1/og",
apiKey = process.env.FASTOG_API_KEY,
hmacSecret = process.env.FASTOG_HMAC_SECRET,
} = options;
if (!apiKey || !hmacSecret) {
throw new Error("Missing FASTOG_API_KEY or FASTOG_HMAC_SECRET");
}
// RFC-3986 percent-encoding: keep A-Za-z0-9-._~
const enc = (s) =>
encodeURIComponent(s).replace(
/[!'()*]/g,
(c) => "%" + c.charCodeAt(0).toString(16).toUpperCase(),
);
// Every query param except the signature, INCLUDING key
const all = { ...params, key: apiKey };
// Canonical query: sorted enc(key)=enc(value) pairs joined with &
const pairs = [];
for (const [k, v] of Object.entries(all)) {
for (const vv of Array.isArray(v) ? v : [v]) {
pairs.push(`${enc(k)}=${enc(vv)}`);
}
}
pairs.sort();
const canonical = pairs.join("&");
// Sign the exact bytes the server will verify
const signature = crypto
.createHmac("sha256", hmacSecret)
.update(`GET/api/v1/og\n${canonical}`)
.digest("hex");
// Build the URL from the same pairs so bytes match the canonical form
const url = new URL(baseUrl);
for (const [k, v] of Object.entries(all)) {
for (const vv of Array.isArray(v) ? v : [v]) {
url.searchParams.append(Array.isArray(v) ? `${k}[]` : k, vv);
}
}
url.searchParams.set("s", signature);
return url.toString();
}
2. Μεταβλητές περιβάλλοντος
# .env.local
FASTOG_API_KEY=sk_your_full_api_key_here
FASTOG_HMAC_SECRET=your_64_char_hex_secret_here
Στατική Δημιουργία Ιστοτόπου (SSG)
// pages/blog/[slug].tsx
import Head from "next/head";
import { generateSignedOgUrl } from "@/lib/og-image-signer";
export default function BlogPost({ post, ogImageUrl }) {
return (
<>
<Head>
<meta property="og:image" content={ogImageUrl} />
<meta property="og:title" content={post.title} />
<meta property="og:description" content={post.excerpt} />
</Head>
<article>
<h1>{post.title}</h1>
<p>{post.excerpt}</p>
</article>
</>
);
}
export async function getStaticPaths() {
const posts = await getAllPosts();
return {
paths: posts.map((post) => ({ params: { slug: post.slug } })),
fallback: "blocking",
};
}
export async function getStaticProps({ params }) {
const post = await getPost(params.slug);
const ogImageUrl = generateSignedOgUrl({
template: "blog",
title: post.title,
subtitle: post.excerpt,
});
return {
props: {
post,
ogImageUrl,
},
revalidate: 3600,
};
}
Απόδοση από την Πλευρά του Διακομιστή (SSR)
// pages/products/[id].tsx
import Head from "next/head";
import { generateSignedOgUrl } from "@/lib/og-image-signer";
export default function Product({ product, ogImageUrl }) {
return (
<>
<Head>
<meta property="og:image" content={ogImageUrl} />
<meta property="og:title" content={product.name} />
</Head>
<main>
<h1>{product.name}</h1>
<p>{product.price}</p>
</main>
</>
);
}
export async function getServerSideProps({ params }) {
const product = await getProduct(params.id);
const ogImageUrl = generateSignedOgUrl({
template: "ecommerce",
title: product.name,
price: product.price,
image: product.image,
});
return {
props: {
product,
ogImageUrl,
},
};
}
Δρομολόγηση API μέσω διακομιστή μεσολάβησης
// pages/api/og.ts
import type { NextApiRequest, NextApiResponse } from "next";
import { generateSignedOgUrl } from "@/lib/og-image-signer";
export default function handler(req: NextApiRequest, res: NextApiResponse) {
const { title, template = "default" } = req.query;
if (!title) {
return res.status(400).json({ error: "Missing title" });
}
const ogImageUrl = generateSignedOgUrl({
template: template as string,
title: title as string,
});
res.json({ ogImageUrl });
}
Συνήθη Σφάλματα
Λάθος Μορφή Μηνύματος
Το υπογεγραμμένο μήνυμα είναι GET/api/v1/og συν μια νέα γραμμή συν το κανονικό query.
❌ Λάθος: GET/api/v1/og + path + apiKey συνενωμένα (χωρίς κανονικό query)
✅ Σωστό: GET/api/v1/og + \n + τα ταξινομημένα enc(key)=enc(value) κανονικά ζεύγη (συμπεριλαμβανομένου του key)
Υπογραφή Διαφορετικών Bytes από Αυτά που Στέλνετε
Δημιουργήστε το τελικό URL από τα ίδια enc(key)=enc(value) ζεύγη που υπογράφετε, διαφορετικά ο διακομιστής επιστρέφει 401 invalid_signature.