POST/api/public/consultation
Zentor veb-saytının ictimai məsləhət sorğu forması.
„POST /api/public/consultation — API-Referenz“ səhifəsi URL-də göstərilən funksional sahəni əhatə edir. Mövcud məzmun faktiki icra axını, ilkin şərtlər və məlum məhdudiyyətlərlə tamamlanır. Forma konstruktoru sərbəst konfiqurasiya oluna bilən formaları trigger açar sözləri, sahə tipləri və məcburi sahə işarələməsi ilə dəstəkləyir. Funksiya E2E-test olunub. `POST /api/public/consultation` sənədləşməsi bu konkret endpoint-in texniki təsviri kimi oxunmalıdır. Əsas əhəmiyyət kəsb edənlər: metod, yol, autentifikasiya, məcburi sahələr, mümkün xətalar və təkrar çağırışın eyni effekti yaradıb-yaratmamasıdır. Mövcud https://zentor-app.de/hilfe/api-referenz/formulare/forms.consultation URL-i buna görə də ümumi reklam ifadələri ehtiva etməməli, yalnız dərhal icra edilə bilən inteqrasiya addımlarını və sübut edilmiş cavab nümunələrini özündə əks etdirməlidir. `/api/public/consultation` çağırışı üçün sorğu registry-ə uyğun qurulur. İctimai routelar ümumi tərtibatçı API açarı tələb etmir, çünki Zentor belə bir açar sistemi təklif etmir. Qorunan vidjet routeları isə bir dəfə göstərilən embed-token və origin yoxlamasından istifadə edir. HTTP statusu və JSON məzmunu birlikdə qiymətləndirilməlidir; tək `ok` sahəsi xəta idarəetməsini əvəz etmir. `POST /api/public/consultation` testində anonimləşdirilmiş dəyərlərdən istifadə edilməlidir. Real müştəri məlumatları, istehsal UUID-ləri, sessiya tokenləri və konkret vaxt damğaları ictimai nümunələrə aid deyil. Məlum platforma miqyaslı hədd 15 dəqiqə ərzində 2.000 sorğudur; fərqli fərdi limit sübut edilməyib. İdempotent olmayan POST çağırışları qeyri-müəyyən şəbəkə kəsilməsindən sonra kor-koranə təkrarlanmamalıdır. Bu route üçün tipik inteqrasiya xətaları çatışmayan məcburi parametrlər, yanlış məlumat tipləri, müddəti bitmiş birdəfəlik kodlar, icazə verilməyən origin-lər və ya əvvəlcədən mövcud olmayan məlumat dəsti səbəbindən yaranır. Tətbiq belə halları ayrıca idarə etməli və endpoint tərəfindən qaytarılan xəta mesajını gizli məzmunları qeyd etmədən loglamalıdır. Uğurlu sorğu yalnız bu emal addımını təsdiqləyir, avtomatik olaraq sonrakı e-poçt, ödəniş və ya SSO uğurunu təsdiqləmir. Bu, „POST /api/public/consultation“ üçün birbaşa aktualdır. Bu səhifənin texniki yoxlanışı məcburi olaraq `app/frontend/src/content/api-reference/` altındakı registry-ə və müvafiq backend routelarına əsaslanmalıdır. Canlı test qeydləri yalnız həqiqətən yoxlanılmış şeyi iddia edə bilər. Mənfi test və ya kod analoqu tam uğur göstəricisi deyil. POST /api/public/consultation — API-Referenz üçün buna görə də sənədləşdirilmiş struktur, avtomatlaşdırılmış test və etibarlı şəkildə müşahidə edilmiş canlı davranış arasında aydın fərq qoyulmalıdır.
Auth & Absicherung
Keine Authentifizierung erforderlich
Idempotent: Nein
Parameter
name(body, string, erforderlich)— 2–120 simvolemail(body, string, erforderlich)— Etibarlı e-poçt ünvanıcompany(body, string)message(body, string)phone(body, string)consentGiven(body, boolean, erforderlich)— Doğru olmalıdırBeispiel-Request
{"name":"Max Mustermann","email":"max@example.com","company":"Musterfirma","message":"müraciət","consentGiven":true}Beispiel-Response
{"ok":true,"message":"Məsləhət sorğunuz ötürüldü. Tezliklə sizinlə əlaqə saxlayacağıq."}Fehlercodes
400 VALIDATION_ERROR — Məcburi sahə yoxdur/etibarsızdır və ya razılıq yoxdur.Live-Test-Nachweis
Uğur (200) və mənfi hal (400) canlı yoxlanıldı.