POST/api/public/contact

Neem 'n versoek van die kontakvorm van die Zentor App-webwerf in ontvangs en stuur dit aan die Zentor-span deur.

Verpligte velde is `name` (2–120 karakters), `email` (geldige e-posadres), `message` (10–3000 karakters) en `consentGiven`, wat op `true` gestel moet word. Opsioneel kan `company`, `phone` en `topic` saamgestuur word. By sukses antwoord die bediener met `{"ok":true}` en 'n bevestigingsboodskap. As 'n verpligte veld ontbreek, ongeldig is of die toestemming ontbreek, antwoord die eindpunt met 400 `VALIDATION_ERROR`; die veld `details` lys die individuele foute, sodat u die betrokke invoervelde kan merk. Elke suksesvolle indiening skep 'n nuwe versoek. Sluit die stuur-knoppie dus tot die antwoord toe en herhaal die oproep nie outomaties 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/contact. 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), message (body), consentGiven (body). Opsionele parameters: company (body), phone (body), topic (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
message(body, string, vereis)— Boodskap, 10–3000 karakters
company(body, string)— Maatskappy (opsioneel)
phone(body, string)— Telefoonnommer (opsioneel)
topic(body, string)— Onderwerp van die navraag (opsioneel)
consentGiven(body, boolean, vereis)— Databeskermingstoestemming, moet `true` wees

Voorbeeldversoek

{"name":"Max Mustermann","email":"max@example.com","message":"Jou boodskap (min. 10 karakters).","consentGiven":true}

Voorbeeldrespons

{"ok":true,"message":"Ihre Anfrage wurde übermittelt."}

Foutkodes

400 VALIDATION_ERROR — 'n Verpligte veld ontbreek of is ongeldig, of die databeskermingstoestemming ontbreek. `details` bevat die individuele foutboodskappe.

Gekontroleerde gedrag

Volledige gegewens lewer 200; ontbrekende verpligte velde of 'n ontbrekende toestemming lewer 400 `VALIDATION_ERROR`.

Openbare vorms

POST /api/public/consultationNeem 'n konsultasieversoek van die vorm van die Zentor App-webwerf in ontvangs.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