Python에서의 OG 이미지
이 가이드에서는 FastOG를 사용하여 Python( Django, FastAPI, Flask)으로 OG 이미지를 생성하는 방법을 보여줍니다. HMAC URL에 서명하고 동적 Open Graph 이미지를 실시간으로 렌더링합니다. 구독 기반이며 무료 계정으로 시작할 수 있습니다(Dynamic API 플랜 선택; 대시보드에서 API 키 생성). 통합하기 전에 템플릿을 미리 확인하려면 무료 OG 이미지 테스터를 사용해 보세요.
Python에서 HMAC 서명된 OG 이미지 URL을 구현하는 완전한 가이드입니다.
빠른 시작
1. 서명 모듈 생성하기
python
# utils/fastog.py
import hmac
import hashlib
import os
from urllib.parse import quote, urlencode
def _enc(s):
return quote(str(s), safe='-._~') # RFC-3986: only unreserved chars
def generate_signed_og_url(params: dict, options: dict = None) -> str:
options = options or {}
base_url = options.get('base_url', os.environ.get('FASTOG_BASE_URL', 'https://fastog.com/api/v1/og'))
api_key = options.get('api_key', os.environ.get('FASTOG_API_KEY'))
hmac_secret = options.get('hmac_secret', os.environ.get('FASTOG_HMAC_SECRET'))
if not api_key or not hmac_secret:
raise ValueError("Missing FASTOG_API_KEY or FASTOG_HMAC_SECRET")
all_params = {**params, 'key': api_key}
pairs = []
for k, v in all_params.items():
for vv in sorted(v if isinstance(v, list) else [v]):
pairs.append(f"{_enc(k)}={_enc(vv)}")
canonical = '&'.join(sorted(pairs))
signature = hmac.new(
hmac_secret.encode(),
f"GET/api/v1/og\n{canonical}".encode(),
hashlib.sha256
).hexdigest()
return f"{base_url}?{urlencode({**all_params, 's': signature})}"
2. 환경 변수 설정
bash
# .env
FASTOG_API_KEY=sk_your_full_api_key_here
FASTOG_HMAC_SECRET=your_64_char_hex_secret_here
bash
pip install python-dotenv
python
# config.py
from dotenv import load_dotenv
load_dotenv()
Django
서명자 서비스
python
# services/fastog.py
from utils.fastog import generate_signed_og_url
class QuickogService:
@staticmethod
def get_og_url(template: str, **params) -> str:
return generate_signed_og_url({
'template': template,
**params,
})
뷰
python
# views.py
from django.shortcuts import render
from services.fastog import QuickogService
def blog_post(request, slug):
post = get_post(slug)
og_image_url = QuickogService.get_og_url(
template='blog',
title=post.title,
subtitle=post.excerpt,
author=post.author.name,
)
return render(request, 'blog/post.html', {
'post': post,
'og_image_url': og_image_url,
})
템플릿
django
{# templates/blog/post.html #}
<!DOCTYPE html>
<html>
<head>
<meta property="og:image" content="{{ og_image_url }}" />
<meta property="og:title" content="{{ post.title }}" />
<meta property="og:description" content="{{ post.excerpt }}" />
</head>
<body>
<h1>{{ post.title }}</h1>
<p>{{ post.excerpt }}</p>
</body>
</html>
사용자 정의 템플릿 태그
python
# templatetags/fastog_tags.py
from django import template
from services.fastog import QuickogService
register = template.Library()
@register.simple_tag
def og_image_url(template_name, **params):
return QuickogService.get_og_url(template_name, **params)
django
{# In template #}
{% load fastog_tags %}
<meta property="og:image" content="{% og_image_url 'blog' title=post.title subtitle=post.excerpt %}" />
FastAPI
python
# main.py
from fastapi import FastAPI, Query
from pydantic import BaseModel
from utils.fastog import generate_signed_og_url
app = FastAPI()
class OgRequest(BaseModel):
title: str
template: str = "default"
subtitle: str | None = None
@app.get("/api/og")
def generate_og(title: str = Query(...), template: str = Query("default")):
og_url = generate_signed_og_url({
'template': template,
'title': title,
})
return {"ogImageUrl": og_url}
@app.get("/blog/{slug}")
async def blog_post(slug: str):
post = await get_post(slug)
og_url = generate_signed_og_url({
'template': 'blog',
'title': post.title,
'subtitle': post.excerpt,
})
return {"post": post, "ogImageUrl": og_url}
Flask
python
# app.py
from flask import Flask, render_template, request, jsonify
from utils.fastog import generate_signed_og_url
app = Flask(__name__)
@app.route("/blog/<slug>")
def blog_post(slug):
post = get_post(slug)
og_image_url = generate_signed_og_url({
'template': 'blog',
'title': post['title'],
'subtitle': post['excerpt'],
})
return render_template('blog/post.html', post=post, og_image_url=og_image_url)
@app.route("/api/og")
def api_og():
title = request.args.get('title')
template = request.args.get('template', 'default')
if not title:
return jsonify({'error': 'Missing title'}), 400
og_url = generate_signed_og_url({
'template': template,
'title': title,
})
return jsonify({'ogImageUrl': og_url})
이커머스 예제
python
# views.py
def product_detail(request, product_id):
product = get_product(product_id)
og_image_url = generate_signed_og_url({
'template': 'ecommerce',
'title': product.name,
'price': product.formatted_price,
'image': product.image_url,
})
return render(request, 'products/detail.html', {
'product': product,
'og_image_url': og_image_url,
})
블로그 게시물 예시
python
def user_profile(request, username):
user = get_user(username)
og_image_url = generate_signed_og_url({
'template': 'blog',
'title': user.name,
'subtitle': user.bio,
'author': user.name,
})
return render(request, 'profile/show.html', {
'user': user,
'og_image_url': og_image_url,
})
흔한 함정
잘못된 메시지 서명
❌ 잘못된 방법: f"GET/api/v1/og{canonical}" — 개행 구분자가 누락됨.
✅ 올바른 방법: f"GET/api/v1/og\n{canonical}" — 메서드 + 경로, 개행, 그 다음 정렬된 쿼리 문자열.
key 서명에서 누락
❌ 잘못된 방법: 콘텐츠 파라미터만 서명하고 key을 URL에 나중에 추가.
✅ 올바른 방법: key은 정렬된 쿼리 문자열을 만들기 전에 파라미터에 병합되며 최종 URL에 나타남.
키와 값의 URL 인코딩을 잊지 않기
❌ 잘못된 방법: 원본 인코딩되지 않은 값으로 정렬된 쿼리 문자열을 빌드.
✅ 올바른 방법: 서명하기 전에 RFC-3986(safe='-._~')에 따라 키와 값을 퍼센트 인코딩 — quote을 사용하고 quote_plus(공백에 대해 +를 생성하며 서버와 일치하지 않음)은 사용하지 마십시오.
401 missing_signature / invalid_signature
missing_signature(401)은 URL에서 key 또는 s이 누락되었음을 의미합니다. invalid_signature(401)은 정렬된 쿼리 문자열이 일치하지 않았음을 의미합니다 — 서명된 메시지의 개행, 양쪽에서 동일한 hmac_secret, 그리고 모든 키와 값에 대해 quote(safe='-._~')(quote_plus이 아님)을 확인하십시오.