POST/api/public/access-request
Trimite o cerere de acces pentru un pachet (Starter, Individual sau demo de 14 zile). Este necesară o adresă de e-mail confirmată anterior.
Confirmați mai întâi adresa de e-mail prin `POST /api/public/access-request/email/start-verification` și `POST /api/public/access-request/email/verify`. Trimiteți apoi `name`, aceeași `email`, pachetul `package` (`starter`, `individual` sau `demo_access`) și `verification_token`-ul primit. Opțional pot fi trimise `company`, `phone`, `companyWebsite`, `paymentMethod` (`paypal`, `kreditkarte`, `rechnung`, `stripe_card` sau `stripe_sepa`), `wish` (`trial`, `subscription` sau `offer`; mereu `trial` pentru accesul demo) și `message`. Fără o confirmare validă, serverul răspunde cu 400 `EMAIL_NOT_VERIFIED`. Câmpurile obligatorii lipsă sau valorile invalide pentru pachet, metodă de plată sau dorință duc la 400 `VALIDATION_ERROR`. Fiecare cerere reușită este creată ca o cerere nouă și procesată de Zentor; nu repetați, deci, apelul automat. Cel mult 10 cereri la fiecare 15 minute per adresă IP. Se aplică, de asemenea, regulile de acces ale Zentor (reguli de IP, țară și domeniu de e-mail); apelurile respinse primesc 403.
Prezentare generală
Apel: POST /api/public/access-request. Acest endpoint aparține grupului „Formulare publice” al API-ului Zentor App. Este accesibil public și nu necesită autentificare. Apelul nu este idempotent: fiecare apel reușit declanșează din nou acțiunea. Parametri obligatorii: name (body), email (body), package (body). Parametri opționali: company (body), phone (body), companyWebsite (body), paymentMethod (body), wish (body), message (body). Cazuri de eroare documentate: 400 VALIDATION_ERROR, 400 EMAIL_NOT_VERIFIED. Răspunsul exemplu de mai jos arată structura unui răspuns reușit în format JSON.
Autentificare și securitate
Nu este necesară autentificarea
Idempotent: Nu
Parametri
name(body, string, obligatoriu)— Nume, 2–120 de caractereemail(body, string, obligatoriu)— Adresă de e-mail confirmată anterior prin `/email/verify`package(body, string, obligatoriu)— Pachet: `starter`, `individual` sau `demo_access`company(body, string)— Companie, max. 160 de caractere (opțional)phone(body, string)— Număr de telefon, max. 40 de caractere (opțional)companyWebsite(body, string)— Site-ul companiei, max. 200 de caractere (opțional)paymentMethod(body, string)— Metodă de plată: `paypal`, `kreditkarte`, `rechnung`, `stripe_card` sau `stripe_sepa` (opțional)wish(body, string)— Dorință: `trial`, `subscription` sau `offer`; mereu `trial` pentru `demo_access` (opțional)message(body, string)— Mesaj, max. 3000 de caractere (opțional)Exemplu de cerere
{"name":"Ion Popescu","email":"max@example.com","package":"demo_access"}Exemplu de răspuns
{"ok":false,"error":"EMAIL_NOT_VERIFIED","message":"Vă rugăm să confirmați mai întâi adresa de e-mail."}Coduri de eroare
400 VALIDATION_ERROR — Lipsește un câmp obligatoriu, sau pachetul, metoda de plată sau dorința sunt invalide.400 EMAIL_NOT_VERIFIED — Adresa de e-mail nu a fost confirmată anterior prin `/email/start-verification` și `/email/verify`, sau `verification_token` lipsește sau este invalid.Comportament verificat
Un corp gol returnează 400 `VALIDATION_ERROR`; date valide fără adresă de e-mail confirmată returnează 400 `EMAIL_NOT_VERIFIED`. Cazul de succes urmează fluxul documentat după confirmarea e-mailului.
Formulare publice
POST /api/public/contactPrimește o solicitare din formularul de contact al site-ului Zentor App și o transmite echipei Zentor.POST /api/public/consultationPrimește o solicitare de consultanță din formularul site-ului Zentor App.POST /api/public/access-request/email/start-verificationTrimite un cod de confirmare din șase cifre, valabil 10 minute, la adresa de e-mail indicată — primul pas al unei cereri de acces.POST /api/public/access-request/email/verifyVerifică codul trimis prin e-mail și emite un token de confirmare pentru cererea de acces ulterioară.GET /api/public/access-request/payment-statusIndică ce metode de plată (PayPal, Stripe) sunt disponibile în prezent pentru cererea de acces.GET /api/public/access-request/paypal/configOferă configurația publică PayPal (activ, mod, monedă) pentru pasul de plată.POST /api/public/access-request/paypal/create-orderCreează o comandă PayPal pentru pachetul selectat.POST /api/public/access-request/paypal/capture-orderFinalizează (capturează) o comandă creată anterior și aprobată de cumpărător în checkout-ul PayPal. Suma este stabilită exclusiv de server.POST /api/public/access-request/stripe/create-checkoutCreează o sesiune de checkout Stripe pentru pachetul selectat.POST /api/public/activate-accountActivează un cont de utilizator nou creat și stabilește prima parolă — declanșat prin linkul din e-mailul de invitație.