POST/api/public/contact
Formula têkilî ya giştî ya malpera Zentor. Ji sîstema navxweyî ya pêşengî daxwaz bike.
`POST /api/public/contact` formulara têkiliyê ya giştî ya malpera Zentor pêvajo dike û daxwazê di pergala Lead ya navxweyî de hilîne. Endpoint hewceyê verastkirina Dashboard nake û ne idempotent e. Her şandina serkeftî dikare Lead-eke nû çêbike. Ji ber vê yekê divê Frontend bişkoja şandinê piştî tikandina yekem neçalak bike û tu dubarekirinên bixweber dernexe. Qadên mecbûrî yên piştrastkirî `name`, `email` û `message` in. Divê nav di navbera 2 û 120 tîpan de be, navnîşana e-nameyê divê formateke derbasdar hebe, û peyam divê rêzikên verastkirinê yên aliyê serverê pêk bîne. Qadên din tenê dikarin werin şandin heke ew di şemaya rastîn de hatibin pêşbînîkirin. Nirxên nenas nabe werin bikaranîn ji bo kontrolkirina taybetmendiyên navxweyî yên Lead-ê. Formulareke rast qadên mecbûrî berê di browserê de kontrol dike, lê tenê xwe bi vê kontrolê ve girê nade. Server dimîne çavkaniya biryardar. Di rewşa xeletiyeke verastkirinê de, divê rûyê qada têkildar nîşan bide û naveroka têketî biparêze. Peyameke serkeftinê ya giştî tenê piştî bersiveke erênî ya server dikare xuya bibe. Formulara têkiliyê ne kanaleke ewle ye ji bo şîfre, mifteyên API, Tokenên Widget, daneyên dayînê an tomarên temam ên xerîdaran. Divê bikarhêner rewşa bikaranînê, berhema têkildar û navnîşaneke e-nameyê ya karsaziyê ya gihîştî binivîse. Di rewşa pirsgirêkeke teknîkî de, navê Tenant, dem, fonksiyona têkildar û gavên dubarekirî bêyî veguhastina naveroka kesane ya bêpêwîst dibin alîkar. Pêvajoyeke rastîn: Mêvan nav, e-name û peyamê tijî dike, ger hewce be nîşeyên parastina daneyan ên rûpelê piştrast dike û formularê dişîne. Server daneyan verast dike, Lead-ê çêdike û bersiveke serkeftî pêşkêş dike. Di rewşa e-nameyeke nederbasdar an navekî pir kurt de, Lead-eke temam çênabe. Endpoint tu Tenant çênake, tu pakêtê nake reserve û şûna mîhengkirina berhemê ya avahîdar an pêvajoya şêwirmendiyê nagire. Ji bo parastina ji Spam û daxwazên rêzikî yên bixweber, divê Client xeletiyên aliyê serverê rêz bigire û tu çerxên bêdawî yên tavilê dest pê neke. Divê bersiveke serkeftî qadên têketinê tenê piştî ku server pejirandinê piştrast kir vala bike. Heke bersiv neyê, dikare bikarhêner naverokê biparêze û paşê bi awayekî kontrolkirî dîsa bişîne. Ji bo dabeşkirina navxweyî, divê peyam sedema rastîn bihewîne, bêyî peyvên marketingê an pêvekên veşartî. Mijareke zelal û danasîneke rasttîr a pirsgirêkê pirsên din kêm dike. Lêbelê API bixwe tu pêşînahiya garantîkirî nade û tu dema pêvajokirinê ya sabît piştrast nake.
Auth & Absicherung
Keine Authentifizierung erforderlich
Idempotent: Nein
Parameter
name(body, string, erforderlich)— 2120 karakteremail(body, string, erforderlich)— E-nameya rastmessage(body, string, erforderlich)— 103000 karaktercompany(body, string)phone(body, string)topic(body, string)consentGiven(body, boolean, erforderlich)— Divê rast be (razîbûna parastina daneyan)Beispiel-Request
{"name":"Max Mustermann","email":"max@example.com","message":"Ihre Nachricht (mind. 10 Zeichen).","consentGiven":true}Beispiel-Response
{"ok":true,"message":"Ihre Anfrage wurde übermittelt."}Fehlercodes
400 VALIDATION_ERROR — Xala mecbûrî tune ye/ne durist e, an jî razîbûna parastina daneyan tune ye (Array Details bi peyamên çewt ên cuda).Live-Test-Nachweis
Serkeftî (200) û neheqî (400, qadên winda û ne razîbûn) zindî hatine piştrastkirin.