OG Images ใน SvelteKit
สร้าง OG images ใน SvelteKit ด้วย FastOG API — ด้วยการสมัครสมาชิก Dynamic API (สร้าง API key ของคุณในแดชบอร์ด), แบบสมัครสมาชิก, รักษาความปลอดภัยด้วย HMAC คู่มือนี้แสดงวิธีสร้างยูทิลิตี้ signer สำหรับ URL ของ OG images ที่ลงนามด้วย HMAC และแสดงผล Open Graph images แบบไดนามิกได้ทันที ใช้ Free OG Image Tester เพื่อดูตัวอย่างก่อนที่คุณจะผสานรวม
เริ่มต้นใช้งานอย่างรวดเร็ว
1. สร้างยูทิลิตี้สำหรับลงนาม (signer)
// src/lib/og-image-signer.js
import crypto from "node: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. ตัวแปรสภาพแวดล้อม (environment variables)
# .env
FASTOG_API_KEY=sk_your_full_api_key_here
FASTOG_HMAC_SECRET=your_64_char_hex_secret_here
หน้าที่มี Metadata
<!-- src/routes/blog/[slug]/+page.svelte -->
<script>
export let data;
$: ({ post, ogImageUrl } = data);
</script>
<svelte:head>
<title>{post.title}</title>
<meta property="og:image" content={ogImageUrl} />
<meta property="og:title" content={post.title} />
<meta property="og:description" content={post.excerpt} />
</svelte:head>
<article>
<h1>{post.title}</h1>
<p>{post.excerpt}</p>
</article>
// src/routes/blog/[slug]/+page.server.js
import { generateSignedOgUrl } from "$lib/og-image-signer";
export async function load({ params }) {
const post = await getPost(params.slug);
const ogImageUrl = generateSignedOgUrl({
template: "blog",
title: post.title,
subtitle: post.excerpt,
author: post.author.name,
});
return {
post,
ogImageUrl,
};
}
เส้นทาง API
// src/routes/api/og/+server.js
import { json } from "@sveltejs/kit";
import { generateSignedOgUrl } from "$lib/og-image-signer";
export async function GET({ url }) {
const title = url.searchParams.get("title");
const template = url.searchParams.get("template") || "default";
if (!title) {
return json({ error: "Missing title" }, { status: 400 });
}
const ogImageUrl = generateSignedOgUrl({
template,
title,
});
return json({ ogImageUrl });
}
ตัวอย่างอีคอมเมิร์ซ
// src/routes/products/[id]/+page.server.js
import { generateSignedOgUrl } from "$lib/og-image-signer";
export async function load({ params }) {
const product = await getProduct(params.id);
const ogImageUrl = generateSignedOgUrl({
template: "ecommerce",
title: product.name,
price: product.price,
image: product.image,
});
return { product, ogImageUrl };
}
<!-- src/routes/products/[id]/+page.svelte -->
<script>
export let data;
$: ({ product, ogImageUrl } = data);
</script>
<svelte:head>
<meta property="og:image" content={ogImageUrl} />
<meta property="og:title" content={product.name} />
</svelte:head>
<main>
<h1>{product.name}</h1>
<p>{product.price}</p>
</main>
โปรไฟล์ผู้ใช้ (เทมเพลตบล็อก)
FastOG ไม่มีเทมเพลต profile — ให้ใช้ blog สำหรับการ์ดสไตล์โปรไฟล์ โดยส่งชื่อผู้ใช้เป็น title ประวัติย่อเป็น subtitle และชื่อเป็น author
// src/routes/users/[username]/+page.server.js
import { generateSignedOgUrl } from "$lib/og-image-signer";
export async function load({ params }) {
const user = await getUser(params.username);
const ogImageUrl = generateSignedOgUrl({
template: "blog",
title: user.name,
subtitle: user.bio,
author: user.name,
});
return { user, ogImageUrl };
}
คอมโพเนนต์ที่มี OG Image แบบไดนามิก
<!-- src/lib/ShareButtons.svelte -->
<script>
import { onMount } from "svelte";
export let post;
let ogImageUrl = null;
onMount(async () => {
const res = await fetch(`/api/og?title=${encodeURIComponent(post.title)}`);
const data = await res.json();
ogImageUrl = data.ogImageUrl;
});
</script>
<div class="share-buttons">
<button on:click={() => shareToTwitter(ogImageUrl)}>
Share on Twitter
</button>
</div>
ข้อผิดพลาดที่พบบ่อย
การลงนามฝั่งไคลเอนต์ (Client-side Signing)
ห้ามลงนาม URL ของ OG ในโค้ดเบราว์เซอร์เด็ดขาด — เพราะความลับ HMAC จะถูกเปิดเผย
❌ ผิด:
<script>
import { generateSignedOgUrl } from "$lib/og-image-signer";
// This runs in the browser!
const ogUrl = generateSignedOgUrl({ title: post.title });
</script>
✅ ถูกต้อง:
// +page.server.js (runs on server only)
import { generateSignedOgUrl } from "$lib/og-image-signer";
export async function load({ params }) {
const ogImageUrl = generateSignedOgUrl({ title: post.title });
return { ogImageUrl };
}
การลงนามข้อมูลที่แตกต่างจากที่ส่งไป
ลายเซ็นครอบคลุม GET/api/v1/og บวกกับอักขระขึ้นบรรทัดใหม่ (newline) และ query แบบ canonical — ซึ่งก็คือคู่ enc(key)=enc(value) ที่เรียงลำดับแล้วของทุกพารามิเตอร์ ยกเว้น s รวมถึง key ด้วย สร้าง URL สุดท้ายจากคู่ที่เข้ารหัสชุดเดียวกันนี้ มิฉะนั้นเซิร์ฟเวอร์จะคืนค่า 401 invalid_signature