Screenshot API

Egy GET-kérés, egy PNG-fájl. A PromNET Screenshot API a Cloudflare Browser Rendering futtatókörnyezetét használja, így nem kell saját Puppeteer-t üzemeltetned, és nem kell várni az SSR-re sem.

Mire jó?

• Social-card auto-generálás — minden új blog-cikkhez automatikus preview-kép.
• Status-page snapshot — ha lemegy az oldalad, mentsd el milyen állapotban volt.
• QA / regression-test — visual diff két verzió között.
• SaaS dashboard — third-party site preview-kép a saját app-odban.

Hogy működik?

A felhasználó-tokenedet (PAT) használod hitelesítésre. A kérés eredménye PNG vagy JPEG byte-stream — közvetlenül használható <img src="..."> tag-ben, vagy elmentheted a saját tárhelyedre.

curl -H "Authorization: Bearer $PROMNET_TOKEN" \
  "https://promnet.hu/api/screenshot?url=https://example.com&width=1200&height=630&format=png" \
  --output example.png

Cache-stratégia

Minden screenshot bekerül egy belső R2-cache-be a paraméter-hash alapján (URL + szélesség + magasság + formátum). Ha 7 napon belül ugyanazt kéred, a cache-ből szolgáljuk ki — ez nem számolódik bele a havi-kvótádba. Ha valódi snapshot kell (mert változott az oldal), módosítsd a méretet vagy várj a cache-lejáratra.

Csomag-szintű kvóták

A cache-ből kiszolgált válasz nem fogyasztja a kvótát — csak a valódi Browser Rendering-hívás. A X-Screenshot-Cache: HIT header árulkodik erről.

Biztonsági korlátozások

• Csak https:// URL-ek (max 2000 karakter)
• Belső IP-k és .internal / .local domain-ek tiltottak
• A promnet.hu önmaga nem screen-shootolható (loop-elhárítás)
• Méret-limitek: 320–1920 px szélesség, 240–1920 px magasság

Részletes dokumentáció

A teljes paraméter-listát, hibakódokat és curl/Node.js/Python példákat itt találod: Screenshot API — súgó.

Token-szerzés

A /app/profil oldalon az API tokenek szekcióban tudsz Personal Access Token-t generálni. A token csak generáláskor látszik egyszer, utána SHA-256 hash-elve tároljuk.