OG-képek gyorsítótárazása
Az OG-képek gyorsítótárazása azt jelenti, hogy egy korábban előállított közösségi előnézetet (social preview) egy CDN-ről szolgálunk ki, ahelyett hogy minden megosztásnál újra renderelnénk. A FastOG az azonos képeket egy évig gyorsítótárazza a peremhálózaton (edge) – ugyanaz az URL a gyorsítótárazott PNG-t adja vissza anélkül, hogy a kvótájába beleszámítana, és közel nulla késleltetéssel, így a webhely OG-forgalmának nagy része soha nem éri el a renderelőt.
Miért fontos a gyorsítótárazás
Egy közösségi megosztás hatására a platform robotja (crawler) lekérést indít. Ha minden megosztás újra renderelődne, akkor azonos tartalomra pazarolná a kvótát és a válaszidőt. Az agresszív gyorsítótárazás – amely a kép tartalma alapján kulcsol – azt eredményezi, hogy „minden megosztás 1 renderelést számít” helyett „az első megosztás 1 renderelést számít, minden további megosztás ingyenes” lesz.
A tartalom-kulcsú modell, ami működővé teszi
A FastOG tartalom-aláírt URL-eket használ: az URL a paraméterek tiszta függvénye. Azonos cím + sablon → azonos URL. Ez azt jelenti:
- A FastOG peremhálózata (edge) az URL alatt tárolja a képet.
- Ugyanazt a tartalmat 10 000-szer osztják meg → egy renderelés, egy kvótaszámítás, 9 999 gyorsítótár-találat.
- A tartalom módosítása → eltérő URL → egy új renderelés.
GET /api/v1/og?title=Hello&template=default&key=...&s=... → render (1 quota count), then
GET /api/v1/og?title=Hello&template=default&key=...&s=... → cached (0 counts, instant)
GET /api/v1/og?title=Changed&template=default&key=...&s=... → render (1 quota count)
A FastOG gyorsítótárazási fejlécei
A FastOG Cache-Control: public, max-age=31536000, immutable (egy év) értéket ad vissza a megjelenített képekhez. Egy borítókép a FastOG élhálózatáról két szinten érhető el: a megjelenítési gyorsítótár a fastog.com előtt, mögötte pedig egy tartós objektumtár. Az ismételt lekérések újramegjelenítés nélkül kerülnek kiszolgálásra, és a válasz X-FastOG-Worker-Cache mezője jelzi, hogy melyik szint válaszolt (HIT, R2, MISS).
Mivel a tartós másolat nem függ a megjelenítőtől, a már legalább egyszer lekérdezett borítókép akkor is kiszolgálásra kerül, ha a FastOG megjelenítési szolgáltatása rövid ideig nem érhető el — egy kiesés nem tünteti el a már legenerált előnézetet. Az egyetlen eset, amikor a megjelenítőre szükség van, az egy még soha nem megjelenített borítókép; ilyenkor a FastOG képként válaszol, nem hibával:
| Helyzet | Amit a crawler kap |
|---|---|
| A borítókép már megjelenítve | a borítókép, az élhálózatról vagy a tartós tárból |
| Még nem megjelenítve, a megjelenítési szolgáltatás elérhető | a borítókép, igény szerint megjelenítve |
| Még nem megjelenítve, a megjelenítési szolgáltatás rövid ideig nem elérhető | az oldal saját képe az URL-ben (az Ön termékfotója), vagy egy semleges kártya — soha nem hibaoldal |
Ha maga a kérés érvénytelen (hamisított aláírás, hiányzó title), akkor is a megfelelő 4xx választ kapja.
Meglévő, már közzétett kép módosítása
| Amit módosított | Teendő |
|---|---|
| A tartalom (cím, ár, fénykép) | semmi: a tartalom az URL-ben található, így az új tartalom új URL-t jelent, és frissen jelenik meg |
| A sablon vagy egy renderelési alapértelmezés | növelje a gyorsítótár-érvénytelenítő verziót (FASTOG_CACHE_BUST), hogy minden URL új v paramétert kapjon |
| Ugyanazt az URL-t újra kell renderelni | kérje a támogatást, hogy töröljék az adott URL-t – a pontos URL-re vonatkozó törlés nem érhető el nyilvános végpontként |
A már megosztott hivatkozások továbbra is működnek, és továbbra is azt a képet mutatják, amelyet ígértek, hacsak nem törli pontosan azt az URL-t.
Saját og:image gyorsítótárazása (saját tárhelyen)
Ha saját maga tárolja a képeket a FastOG gyorsítótára helyett, ugyanazokat a szabályokat alkalmazza:
| Lépés | Részletek |
|---|---|
| Gyorsítótár-kulcs = tartalom hash | Tárolja az adatok hash-e alapján, ne változó fájlnév alapján |
| Hosszú TTL | max-age=31536000, immutable stabil tartalom esetén |
| Verziózott URL-ek | Tartalomváltozáskor adjon hozzá hash-t/verziót |
| CDN elöl | A CDN nyelje el az ismételt lekéréseket |
GYIK
A megosztások ismétlése valóban 0 renderelésbe kerül?
Igen. Az azonos URL-ek a peremhálózati gyorsítótárba (edge cache) kerülnek, és soha nem érik el a renderelőt — így nem fogyasztanak kvótát.
Meddig gyorsítótárazza a FastOG egy képet?
Egy évig (immutable). Az első renderelés után jóval a megosztott kártya már a gyorsítótárból kerül kiszolgálásra.
Mi történik, ha azt szeretném, hogy egy kép frissüljön (pl. élő ár)?
Módosítson egy paramétert (az árat) → új URL → új renderelés. A stabil tartalom gyorsítótárazva marad; a dinamikus tartalom akkor frissül, amikor Ön szeretné.