API dokumentáció

Alapok

Mobil-előnézet API

Egy weboldal címéből bemutató képet (mockupot) készít: az oldal laptopon, tableten és mobilon, választható háttér előtt, 2400 × 1500 px-es PNG, JPG és WebP képként. A kulcs előtagja kvm_. Az azonos címre és háttérre néhány órán belül kért képet a gyorsítótárból adjuk (cached: true, nem fogy a kvóta).

{
  "id": "01J…",
  "status": "queued",
  "queue_position": 2,
  "url": "https://example.com",
  "background": { "type": "gradient", "stops": ["#00bcfe", "#3b82f6", "#8b5cf6"], "angle": 135, "preset": "kodvena" },
  "files": null,
  "error": null,
  "expires_at": "2026-10-19T10:00:00+02:00",
  "created_at": "2026-10-18T10:00:00+02:00"
}

{
  "id": "01J…",
  "status": "done",
  "final_url": "https://example.com/",
  "title": "Example Domain",
  "files": {
    "png": { "url": "https://kodvena.hu/api/v1/mockup/renders/01J…/files/mockup.png?expires=…&signature=…", "download_url": "…&download=1", "bytes": 1843210 },
    "webp": { "url": "…", "download_url": "…", "bytes": 312004 }
  },
  "finished_at": "2026-10-18T10:00:21+02:00"
}

Teljes példa

# 1. render kérése
curl -X POST https://kodvena.hu/api/v1/mockup/renders \
  -H "Authorization: Bearer kvm_…" -H "Content-Type: application/json" \
  -d '{"url":"https://example.com","background":{"preset":"ejfel"}}'

# 2. állapot, amíg "done" vagy "failed" nem lesz (pár másodpercenként)
curl https://kodvena.hu/api/v1/mockup/renders/01J…

# 3. letöltés a files.png.download_url címről
curl -L -o mockup.png "<files.png.download_url>"

# saját háttérképpel
curl -X POST https://kodvena.hu/api/v1/mockup/renders -H "X-Api-Key: kvm_…" \
  -F url=https://example.com -F [email protected]

Képoptimalizáló API

Egy kötegben több képet tömörít, méretez át vagy alakít más formátumra. Bemenet: image/jpeg, image/png, image/webp, image/avif. Ha az eredmény nagyobb lenne az eredetinél, az eredetit kapod vissza (kept_original: true). A kulcs előtagja kvk_.

{
  "token": "Zm9…40 karakter",
  "id": "01J…",
  "settings": { "format": "webp", "mode": "lossy", "quality": 78, "maxWidth": null, "maxHeight": null, "stripMetadata": true },
  "done": false,
  "progress": 0,
  "counts": { "total": 2, "queued": 2, "processing": 0, "done": 0, "failed": 0 },
  "files": [ { "id": "01J…", "name": "foto.jpg", "status": "queued", "queue_position": 1, "in_bytes": 2480012, "result_url": null } ],
  "events_url": "https://kodvena.hu/api/v1/kepoptimalizalo/batches/01J…/events?token=…",
  "expires_at": "2026-10-18T11:00:00+02:00"
}

Teljes példa

# 1. feltöltés
curl -X POST https://kodvena.hu/api/v1/kepoptimalizalo/batches -H "X-Api-Key: kvk_…" \
  -F "files[][email protected]" -F "files[][email protected]" \
  -F format=webp -F quality=78 -F max_width=1920

# 2. állapot (a válaszból: id és token)
curl -H "X-Batch-Token: <token>" https://kodvena.hu/api/v1/kepoptimalizalo/batches/<id>

# 3. minden kész kép ZIP-ben
curl -L -o kepek.zip "https://kodvena.hu/api/v1/kepoptimalizalo/batches/<id>/zip?token=<token>"

Cookie banner generátor API

GDPR-kompatibilis süti-bannert generál: egyetlen, függőség nélküli JavaScript fájlt, amelyet a weboldal <head> részébe kell tenni. A hozzájárulásig a statisztikai és marketing kódok nem futnak: ezeket <script type="text/plain" data-category="analytics"> formában kell beilleszteni (a válasz snippets mezője kész kódrészleteket ad). Kulcs nem kell, a korlátok IP-címenként érvényesek.

{
  "params": { "policy_url": "https://example.com/adatkezeles", "theme": "sotet", "layout": "bar", "categories": ["necessary", "analytics", "marketing"], "services": ["ga4"], "days": 180 },
  "code": "/* Kódvéna cookie banner … */ (function(){ … })();",
  "html": "<script>\n…\n</script>",
  "bytes": 14210,
  "snippets": [ { "key": "reopen", "title": "Visszanyitó link a láblécbe (kötelező)", "category": "necessary", "code": "<a href=\"#suti-beallitasok\" data-kv-consent-open>Süti beállítások</a>" } ],
  "generator_version": "…"
}

Példa

curl "https://kodvena.hu/api/v1/cookiebanner/generate?policy_url=https://example.com/adatkezeles&theme=sotet&services[]=ga4&format=js" -o cookie-banner.js

# a weboldal <head> részébe, minden más szkript elé:
<script src="/cookie-banner.js"></script>

Hibakezelés

Hibánál a válasz JSON: message (magyar, megjeleníthető szöveg), code (géppel feldolgozható) és mezőhibánál errors (mezőnként). A leggyakoribbak:

Kérdésed van, vagy nagyobb kvóta kellene? Írj nekünk egy ticketet az ügyfélportálon.