POST/api/public/consultation

Neem 'n konsultasieversoek van die vorm van die Zentor App-webwerf in ontvangs.

Verpligte velde is `name` (2–120 karakters), `email` (geldige e-posadres) en `consentGiven`, wat op `true` gestel moet word. Opsioneel kan `company`, `phone` en `message` saamgestuur word. By sukses antwoord die bediener met `{"ok":true}` en 'n bevestigingsboodskap; die Zentor-span kontak u daarna. As 'n verpligte veld ontbreek, ongeldig is of die toestemming ontbreek, antwoord die eindpunt met 400 `VALIDATION_ERROR`. Elke suksesvolle oproep skep 'n nuwe versoek; die oproep is dus nie idempotent nie. Hoogstens 10 versoeke per 15 minute per IP-adres. Daarbenewens geld Zentor se toegangsreëls (IP-, land- en e-posdomeinreëls); verworpe oproepe kry 403.

Oorsig

Oproep: POST /api/public/consultation. Hierdie eindpunt behoort tot die groep “Openbare vorms” van die Zentor App-API. Dit is publiek toeganklik en vereis geen verifikasie nie. Die oproep is nie idempotent nie: elke suksesvolle oproep aktiveer die aksie opnuut. Verpligte parameters: name (body), email (body), consentGiven (body). Opsionele parameters: company (body), message (body), phone (body). Gedokumenteerde foutgevalle: 400 VALIDATION_ERROR. Die voorbeeldrespons hieronder toon die struktuur van ’n suksesvolle respons in JSON-formaat.

Verifikasie en sekuriteit

Geen verifikasie vereis nie

Idempotent: Nee

Parameters

name(body, string, vereis)— Naam, 2–120 karakters
email(body, string, vereis)— Geldige e-posadres
company(body, string)— Maatskappy (opsioneel)
message(body, string)— Boodskap (opsioneel)
phone(body, string)— Telefoonnommer (opsioneel)
consentGiven(body, boolean, vereis)— Databeskermingstoestemming, moet `true` wees

Voorbeeldversoek

{"name":"Max Mustermann","email":"max@example.com","company":"Voorbeeldmaatskappy","message":"Navraag","consentGiven":true}

Voorbeeldrespons

{"ok":true,"message":"Ihre Beratungsanfrage wurde übermittelt. Wir melden uns in Kürze bei Ihnen."}

Foutkodes

400 VALIDATION_ERROR — 'n Verpligte veld ontbreek of is ongeldig, of die toestemming ontbreek.

Gekontroleerde gedrag

Volledige gegewens lewer 200; ontbrekende of ongeldige gegewens lewer 400 `VALIDATION_ERROR`.

Openbare vorms

POST /api/public/contactNeem 'n versoek van die kontakvorm van die Zentor App-webwerf in ontvangs en stuur dit aan die Zentor-span deur.POST /api/public/access-requestDien 'n toegangsaanvraag vir 'n pakket in (Starter, Individueel of 14-dae-demo). Voorvereiste is 'n voorheen bevestigde e-posadres.POST /api/public/access-request/email/start-verificationStuur 'n sescijferkode, 10 minute geldig, aan die verstrekte e-posadres – die eerste stap van 'n toegangsaanvraag.POST /api/public/access-request/email/verifyKontroleer die kode wat per e-pos afgelewer is en gee 'n bevestigingstoken uit vir die daaropvolgende toegangsaanvraag.GET /api/public/access-request/payment-statusDui aan welke betaalmetodes (PayPal, Stripe) tans vir die toegangsaanvraag beskikbaar is.GET /api/public/access-request/paypal/configLewer die openbare PayPal-konfigurasie (aktief, modus, geldeenheid) vir die betaalstap.POST /api/public/access-request/paypal/create-orderSkep 'n PayPal-bestelling vir die gekose pakket.POST /api/public/access-request/paypal/capture-orderSluit 'n voorheen geskepte en deur die koper in die PayPal-afhandeling vrygegewe bestelling af (Capture). Die bedrag bepaal slegs die bediener.POST /api/public/access-request/stripe/create-checkoutSkep 'n Stripe-afrekeningsessie vir die gekose pakket.POST /api/public/activate-accountAktiveer 'n nuut aangelegde gebruikersrekening en stel die eerste wagwoord – ontlok via die skakel in die uitnodigings-e-pos.

Verwante artikels

← Openbare vorms