OG-kuvien välimuistittaminen
OG-kuvien välimuistittaminen tarkoittaa aiemmin luodun sosiaalisen esikatselun (social preview) tarjoamista CDN:stä sen sijaan, että se renderöitäisiin uudelleen jokaisen jakamisen yhteydessä. FastOG välimuistittaa identtiset kuvat reunalla (edge) vuoden ajaksi — sama URL palauttaa välimuistissa olevan PNG-kuvan kuluttamatta kiintiötäsi ja lähes nollan viiveen ansiosta suurin osa sivuston OG-liikenteestä ei koskaan kosketa renderöijää.
Miksi välimuisti on tärkeää
Sosiaalisen median jakaminen saa alustan hakurobotin hakemaan sisällön. Jos jokainen jako renderöitäisiin uudelleen, kuluttaisit kiintiötä ja lisäisit viivettä identtiseen sisältöön. Aggressiivinen välimuisti — joka perustuu kuvan sisältöön — muuttaa tilanteen "jokainen jako maksaa yhden renderöinnin" muotoon "ensimmäinen jako maksaa yhden renderöinnin, kaikki muut jaot ovat ilmaisia."
Sisältöavainmalli, joka saa sen toimimaan
FastOG käyttää sisältöallekirjoitettuja URL-osoitteita: URL on parametrien puhdas funktio. Identtinen otsikko + malli → identtinen URL. Tämä tarkoittaa:
- FastOG:n reuna pitää kuvan URL-osoitteen alla.
- Sama sisältö jaettuna 10 000 kertaa → yksi renderöinti, yksi kiintiölaskenta, 9 999 välimuistiosumaa.
- Muuta sisältöä → eri URL → yksi uusi renderöinti.
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)
FastOG:n välimuistin otsakkeet
FastOG palauttaa Cache-Control: public, max-age=31536000, immutable (yhden vuoden) renderöidyille kuville. Kansi
palvellaan FastOG:n reunalta kahdessa tasossa: renderöintivälimuisti fastog.com:n edessä ja pysyvä
objektivarasto sen takana. Toistuvat haut vastataan ilman uudelleenrenderöintiä, ja X-FastOG-Worker-Cache
vastauksessa kertoo, mikä taso vastasi (HIT, R2, MISS).
Koska pysyvä kopio ei riipu renderöijästä, kannet, jotka on haettu vähintään kerran, jatkavat palvelua, vaikka FastOG:n renderöintipalvelu olisi hetkellisesti pois käytöstä — käyttökatkos ei tyhjennä esikatselua, joka on jo luotu. Kansi, jota ei ole koskaan renderöity, on ainoa tapaus, joka tarvitsee renderöijän, ja siinä FastOG vastaa kuvalla virheen sijaan:
| Tilanne | Mitä hakurobotti saa |
|---|---|
| Kansi jo renderöity | kannen, reunalta tai pysyvästä varastosta |
| Ei koskaan renderöity, renderöintipalvelu toimii | kannen, renderöitynä pyynnöstä |
| Ei koskaan renderöity, renderöintipalvelu hetkellisesti alhaalla | sivun oman kuvan URL:ssä (tuotekuvasi) tai neutraalin kortin — ei koskaan virhesivua |
Jos itse pyyntö on virheellinen (peukaloitu allekirjoitus, puuttuva title), saat silti vastaavan 4xx-virheen.
Jo julkaistun kuvan muuttaminen
| Muutit | Mitä tehdä |
|---|---|
| Sisällön (otsikko, hinta, valokuva) | ei mitään: sisältö on URL-osoitteessa, joten uusi sisältö on uusi URL-osoite ja renderöityy tuoreena |
| Mallipohjan tai renderöinnin oletusarvon | nosta cache-bust-versionumeroa (FASTOG_CACHE_BUST), jotta jokainen URL-osoite saa uuden v-parametrin |
| Tarvitset saman URL-osoitteen renderöitäväksi uudelleen | pyydä tukea tyhjentämään kyseinen URL-osoite — tarkan URL-osoitteen tyhjennystä ei ole tarjolla julkisena päätepisteenä |
Jo jaetut linkit toimivat edelleen ja näyttävät edelleen sen kuvan, jonka ne lupasivat, ellet tyhjennä täsmälleen sitä URL-osoitetta.
Oma og:image-välimuisti (itse isännöity)
Jos tallennat kuvat itse FastOG:n välimuistin sijaan, noudata samoja sääntöjä:
| Vaihe | Yksityiskohta |
|---|---|
| Välimuistin avain = sisällön tiiviste | Tallenna tiedon tiivisteen perusteella, älä muuttuvan tiedostonimen mukaan |
| Pitkä TTL | max-age=31536000, immutable vakaalle sisällölle |
| Versioidut URL-osoitteet | Lisää tiiviste/versio, kun sisältö muuttuu |
| CDN edessä | Anna CDN:n hoitaa toistuvat noudot |
UKK
Maksavatko toistuvat jaot todella 0 renderöintiä?
Kyllä. Identtiset URL-osoitteet osuvat reunavälimuistiin (edge cache) eivätkä koskaan saavuta renderöijää — kiintiötä ei kulu.
Kuinka kauan FastOG välimuistittaa kuvan?
Yhden vuoden (immutable). Kauan ensimmäisen renderöinnin jälkeen jaettu kortti haetaan välimuistista.
Entä jos haluan kuvan päivittyvän (esim. live-hinta)?
Muuta parametria (hinta) → uusi URL → uusi renderöinti. Vakaa sisältö pysyy välimuistissa; dynaaminen sisältö päivittyy, kun haluat.