▲ PromNET

SÚGÓ › Felhő tárhely

Form-handler — beágyazható űrlap-fogadó endpoint

A saját honlapod űrlapjait küldd a PromNET-be — nincs backend kód, e-mail értesítés, dashboard-on listázott submission-ok.

Egy egyszerű honlap (Astro static, WP, Wix) sem jó “Kapcsolat” form nélkül. A PromNET Form-handler szolgáltatása backend kód nélkül fogadja a submitokat, e-mailbe küldi, dashboard-on listázza.

Hogyan működik?

  1. Létrehozol egy form-endpointot a /app/forms oldalon
  2. Kapsz egy URL-t, pl. https://promnet.hu/api/forms/submit/fm_abc123
  3. A saját honlapod űrlapja a <form action=""> attribútumába teszi ezt
  4. Submit után PromNET:
    • Bevezeti az adatokat egy D1-tárolóba (dashboard-on lista)
    • E-mailt küld neked a megadott címre
    • (opcionálisan) Webhook-on POST-olja egy másik szolgáltatásnak

Példa HTML-form

<form action="https://promnet.hu/api/forms/submit/fm_abc123" method="POST">
  <label>Név <input type="text" name="name" required></label>
  <label>Email <input type="email" name="email" required></label>
  <label>Üzenet <textarea name="message"></textarea></label>

  <!-- Honeypot: bot kitölti, mi eldobjuk a submissiont -->
  <input type="text" name="_gotcha" style="display:none">

  <button type="submit">Küldés</button>
</form>

Funkciók

  • Spam-szűrés: a _gotcha honeypot mezőt csak bot-ok töltik ki — auto-eldobjuk
  • Origin-allowlist: csak a saját honlapodról fogadjon submitot (pl. https://eskuvo.hu)
  • Köszönő-oldal: submit után átirányítjuk a látogatót egy te-általad megadott URL-re
  • Webhook-továbbítás: minden submission JSON-ben elküldhető egy Zapier / Make.com URL-re is
  • Rate-limit: 30 submission / IP / óra (DDoS-védelem)
  • Méret-limit: 50 KB submission

Kvóta

Cloud Free csomagban is működik (5 form-endpoint). Cloud Pro-ban 20.

E-mail formátum

Szép HTML-mail jön (a PromNET branding-jével), JSON-payload-szerűen listázott mezők. Plusz a submission-id egy linket tartalmaz a /app/forms/<id> dashboard-oldalra.

Submission letöltés CSV-ben

A dashboard /app/forms/<id> oldalán van “Letöltés CSV” gomb (hamarosan). Most JSON-letöltés a REST API-n: /api/account/forms/<id>/submissions.

XHR-flow (SPA-ból)

Ha JavaScript-ből submitelsz (nem natív HTML-form), küldj Content-Type: application/json-t — válaszként JSON jön ({ ok: true, id: "fs_..." }) redirect helyett.

const r = await fetch('https://promnet.hu/api/forms/submit/fm_abc123', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({ name: 'Anna', email: '[email protected]', message: 'Hello' }),
});
const j = await r.json();
console.log(j.ok ? 'Köszi!' : 'Hiba: ' + j.error);

CORS

A form-endpoint preflight-támogatja. Ha az allowed_origins üres, bárhonnan működik. Ha kitöltöd, csak a megadott origin(ek)-ről fogadunk submitot.

Adatkezelés

  • A submitter IP-jét és user-agent-jét tároljuk (60 napig) spam-felderítésre
  • A submission-fields-t a tied (a felhasználó kezeli a saját adatait)
  • Ha hatósági megkeresés érkezik, a submitter IP-jét kiadjuk (ÁSZF 11 — Hatósági együttműködés)
← Felhő tárhely Frissítve: 2026. 05. 01.