Konu

İmzalı OG Görsel URL'leri

İmzalı bir OG görsel URL'si, parametreleri HMAC-SHA256 imzasıyla korunan bir URL'dir; böylece yalnızca siz (ve gizli anahtarınızı tutan kod), aylık kotanıza sayılan işlemleri talep edebilirsiniz. FastOG içeriği imzalar — aynı parametreler her zaman aynı, önbelleğe alınmış URL'yi üretir — bu hem kotanızı korur hem de önbellekleme işlemini belirleyici kılar.

OG görsel URL'lerini neden imzalamalısınız?

Kimliği doğrulanmamış bir URL'den rastgele metin işleyen bir OG görsel uç noktası, herkesin kullanabileceği ücretsiz bir işleme çiftliğidir. Abonelik tabanlı bir hizmette bu, herkesin bakiyenizi tüketebileceği anlamına gelir. Her URL'yi yalnızca arka uç sisteminizin bildiği bir sırla imzalamak, ilk (önbelleğe alınmamış) istekte yetkisiz tüm istekleri engellerken, meşru ve önbelleğe alınmış URL'ler çalışmaya devam eder.

İçerik imzalama nasıl çalışır

Kurallı sorgu dizesini oluşturursunuz: her parametre (imza hariç), sıralanmış ve RFC-3986 kodlanmış şekilde.
HMAC_SHA256(secret, "GET/api/v1/og\n" + canonical) değerini hesaplarsınız.
İmzayı s parametresi olarak eklersiniz.

Mesaj bir zaman damgası içermez, bu nedenle URL sabittir: aynı parametreler → aynı URL → aynı önbellek girdisi.

canonical = "key=sk_...&template=default&title=Hello"
signature = HMAC-SHA256(secret, "GET/api/v1/og\n" + canonical)
url = ".../api/v1/og?key=...&template=default&title=Hello&s=" + signature

İnsanların yanlış anladığı denge

Endişe	Gerçek
"İmzalı bir URL'nin süresi dolar"	Hayır — içerik imzalıdır, sırrı döndürene kadar geçerlidir
"Kurcalanmış bir URL önbelleği bozar"	Hayır — geçersiz bir `s` yalnızca önbellek kaçırma durumunda 401 alır; önbelleğe alınmış görseller yine de döner
"Güvenlik için zaman damgalarına ihtiyacım var"	Kota kötüye kullanımını durdurmak için içerik imzalama yeterlidir; saate gerek yoktur

Tek Dosyalık SDK’lar

FastOG, her dil için tek bir imzalayıcı dosyası sunar (sıfır bağımlılık), böylece HMAC’i asla elle yazmak zorunda kalmazsınız. SDK sayfasından indirin veya doğrudan CDN’den curl alın:

bash

curl -O https://fastog.com/sdk/node.js

SSS

İmzalı URL'lerin süresi hiç dolar mı?

Varsayılan olarak hayır — API anahtarının HMAC sırrını döndürene kadar geçerli kalırlar. İçerik imzalıdır, zaman imzalı değildir.

Bir başkası URL'yi tahmin ederek benim kotamı kullanabilir mi?

Hayır. Geçerli bir imza oluşturmak için HMAC sırrına ihtiyaçları vardır; bu olmadan, önbelleğe alınmamış işlemeler 401 invalid_signature döndürür.

URL'yi tarayıcıda mı imzalarım?

Hayır. Sırrın asla istemciye gönderilmediği sunucu tarafında (veya bir edge fonksiyonunda) imzalayın. Oluşturulan görsel URL'sini herkese açık <head> alanına koymak güvenlidir.

Ücretsiz deneyin — kayıt gerekmez

Dinamik OG görsellerini saniyeler içinde önizleyin ve test edin.

Ücretsiz OG Görsel Test Aracını Aç