POST/api/public/contact

Primește o solicitare din formularul de contact al site-ului Zentor App și o transmite echipei Zentor.

Câmpurile obligatorii sunt `name` (2–120 de caractere), `email` (adresă de e-mail validă), `message` (10–3000 de caractere) și `consentGiven`, care trebuie să fie setat pe `true`. Opțional pot fi trimise `company`, `phone` și `topic`. În caz de succes, serverul răspunde cu `{"ok":true}` și un mesaj de confirmare. Dacă lipsește un câmp obligatoriu, este invalid sau lipsește consimțământul, endpointul răspunde cu 400 `VALIDATION_ERROR`; câmpul `details` listează erorile individuale, astfel încât să puteți marca câmpurile afectate. Fiecare trimitere reușită creează o nouă solicitare. Dezactivați, deci, butonul de trimitere până la primirea răspunsului și nu repetați 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/contact. 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), message (body), consentGiven (body). Parametri opționali: company (body), phone (body), topic (body). Cazuri de eroare documentate: 400 VALIDATION_ERROR. 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 caractere
email(body, string, obligatoriu)— Adresă de e-mail validă
message(body, string, obligatoriu)— Mesaj, 10–3000 de caractere
company(body, string)— Companie (opțional)
phone(body, string)— Număr de telefon (opțional)
topic(body, string)— Subiectul solicitării (opțional)
consentGiven(body, boolean, obligatoriu)— Consimțământ privind protecția datelor, trebuie să fie `true`

Exemplu de cerere

{"name":"Max Mustermann","email":"max@example.com","message":"Mesajul dumneavoastră (minim 10 caractere).","consentGiven":true}

Exemplu de răspuns

{"ok":true,"message":"Solicitarea dumneavoastră a fost trimisă."}

Coduri de eroare

400 VALIDATION_ERROR — Un câmp obligatoriu lipsește sau este invalid, sau lipsește consimțământul privind protecția datelor. `details` conține mesajele de eroare individuale.

Comportament verificat

Datele complete returnează 200; câmpurile obligatorii lipsă sau consimțământul lipsă returnează 400 `VALIDATION_ERROR`.

Formulare publice

POST /api/public/consultationPrimește o solicitare de consultanță din formularul site-ului Zentor App.POST /api/public/access-requestTrimite o cerere de acces pentru un pachet (Starter, Individual sau demo de 14 zile). Este necesară o adresă de e-mail confirmată anterior.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.

Articole similare

← Formulare publice