POST/api/public/access-request

Dien 'n toegangsaanvraag vir 'n pakket in (Starter, Individueel of 14-dae-demo). Voorvereiste is 'n voorheen bevestigde e-posadres.

Bevestig eerstens die e-posadres via `POST /api/public/access-request/email/start-verification` en `POST /api/public/access-request/email/verify`. Stuur dan `name`, dieselfde `email`, die pakket `package` (`starter`, `individual` of `demo_access`) en die ontvangde `verification_token`. Opsioneel is `company`, `phone`, `companyWebsite`, `paymentMethod` (`paypal`, `kreditkarte`, `rechnung`, `stripe_card` of `stripe_sepa`), `wish` (`trial`, `subscription` of `offer`; by demo-toegang altyd `trial`) en `message`. Sonder geldige bevestiging antwoord die bediener met 400 `EMAIL_NOT_VERIFIED`. Ontbrekende verpligte velde of ongeldige waardes vir pakket, betaalmetode of wens lei tot 400 `VALIDATION_ERROR`. Elke suksesvolle aanvraag word opnuut geskep en deur Zentor verwerk; herhaal die oproep dus 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/access-request. 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), package (body). Opsionele parameters: company (body), phone (body), companyWebsite (body), paymentMethod (body), wish (body), message (body). Gedokumenteerde foutgevalle: 400 VALIDATION_ERROR, 400 EMAIL_NOT_VERIFIED. 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)— E-posadres wat voorheen via `/email/verify` bevestig is
package(body, string, vereis)— Pakket: `starter`, `individual` of `demo_access`
company(body, string)— Maatskappy, maks. 160 karakters (opsioneel)
phone(body, string)— Telefoonnommer, maks. 40 karakters (opsioneel)
companyWebsite(body, string)— Webwerf van die maatskappy, maks. 200 karakters (opsioneel)
paymentMethod(body, string)— Betaalwyse: `paypal`, `kreditkarte`, `rechnung`, `stripe_card` of `stripe_sepa` (opsioneel)
wish(body, string)— Wens: `trial`, `subscription` of `offer`; by `demo_access` altyd `trial` (opsioneel)
message(body, string)— Boodskap, maks. 3000 karakters (opsioneel)

Voorbeeldversoek

{"name":"Jan Alleman","email":"max@example.com","package":"demo_access"}

Voorbeeldrespons

{"ok":false,"error":"EMAIL_NOT_VERIFIED","message":"Bitte bestätigen Sie zuerst Ihre E-Mail-Adresse."}

Foutkodes

400 VALIDATION_ERROR — 'n Verpligte veld ontbreek, of pakket, betaalwyse of wens is ongeldig.
400 EMAIL_NOT_VERIFIED — Die e-posadres is nie voorheen via `/email/start-verification` en `/email/verify` bevestig nie, of die `verification_token` ontbreek of is ongeldig.

Gekontroleerde gedrag

'n Leë body lewer 400 `VALIDATION_ERROR`; geldige data sonder bevestigde e-posadres lewer 400 `EMAIL_NOT_VERIFIED`. Die suksesgeval volg ná die e-posbevestiging die gedokumenteerde verloop.

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