Forms

Dokumentáció

Minden, ami a Sveov Forms weboldaladba építéséhez kell – 100 % tervezési szabadsággal.

1. Alapelv

Minden űrlapnak saját végpont-URL-je van. A HTML-űrlapod POST-tal küld oda – kész. Támogatott formátumok: application/x-www-form-urlencoded, multipart/form-data (fájlfeltöltés) és application/json.

<form action="https://forms.sveov.com/f/SAJAT_URLAP_ID" method="POST">
  <label>Név<br><input type="text" name="nev" required></label>
  <label>E-mail<br><input type="email" name="email" required></label>
  <label>Telefon (opcionális)<br><input type="tel" name="telefon"></label>
  <label>Üzenet<br><textarea name="uzenet" rows="5" required></textarea></label>

  <!-- Honeypot: emberek számára láthatatlan, a botok kitöltik -->
  <input type="text" name="_gotcha" tabindex="-1" autocomplete="off"
         style="position:absolute;left:-9999px" aria-hidden="true">

  <!-- DSGVO-hozzájárulás -->
  <label>
    <input type="checkbox" name="adatvedelem" value="elfogadva" required>
    Elolvastam az adatvédelmi tájékoztatót, és hozzájárulok
    adataim kezeléséhez.
  </label>

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

2. Speciális mezők

3. AJAX / JSON

Küldd az Accept: application/json fejlécet, hogy átirányítás helyett JSON-választ kapj:

fetch("https://forms.sveov.com/f/SAJAT_URLAP_ID", {
  method: "POST",
  headers: { "Content-Type": "application/json", "Accept": "application/json" },
  body: JSON.stringify({ nev: "Max", email: "max@example.com", uzenet: "Szia!" })
})
// Válasz: { "ok": true, "id": "..." }

4. Spamvédelem

5. Webhookok

Űrlaponként webhookokat hozhatsz létre (Premium). Minden beküldést JSON-ként, POST-tal kézbesítünk. Ellenőrzéshez minden kérés tartalmazza az X-Sveov-Signature fejlécet (a törzs HMAC-SHA256 aláírása a webhook-titkoddal). Szabályokkal (pl. a tema mező tartalmazza: support) tartalom szerint továbbíthatod a beküldéseket különböző eszközökhöz.

6. JSON API

API-kulccsal (Fiók → API) programozottan olvashatod és kezelheted a beküldéseket:

GET    /api/v1/forms
GET    /api/v1/forms/:id/submissions?status=NEW&since=2026-07-01
GET    /api/v1/submissions/:id
PATCH  /api/v1/submissions/:id      {"status":"DONE","isLead":true}
DELETE /api/v1/submissions/:id

Authorization: Bearer sv_sajat_api_kulcs

7. DSGVO-ellenőrzőlista az űrlapodhoz