POST/api/public/consultation

Zentor இணையதளத்தின் பொது ஆலோசனைக் கோரிக்கைப் படிவம்.

"POST /api/public/consultation — API குறிப்பு" பக்கம் URL-இல் குறிப்பிடப்பட்ட செயல்பாட்டுப் பகுதியைக் கையாள்கிறது. ஏற்கனவே உள்ள உள்ளடக்கம் உண்மையான ஓட்டம், முன்நிபந்தனைகள் மற்றும் அறியப்பட்ட வரம்புகளுடன் விரிவுபடுத்தப்படுகிறது. படிவ உருவாக்கி Trigger-முக்கியச் சொற்கள், புல வகைகள் மற்றும் கட்டாயப் புலக் குறியிடலுடன் சுதந்திரமாக உள்ளமைக்கக்கூடிய படிவங்களை ஆதரிக்கிறது. இந்தச் செயல்பாடு E2E சோதனை செய்யப்பட்டுள்ளது. `POST /api/public/consultation` ஆவணத்தை இந்தக் குறிப்பிட்ட முனைப்புள்ளியின் தொழில்நுட்ப விளக்கமாகப் படிக்க வேண்டும். Method, Path, அங்கீகாரம், கட்டாயப் புலங்கள், சாத்தியமான பிழைகள் மற்றும் மீண்டும் அழைத்தால் அதே விளைவு ஏற்படுமா என்பதே முக்கியமானவை. எனவே URL https://zentor-app.de/hilfe/api-referenz/formulare/forms.consultation பொதுவான விளம்பரக் கூற்றுகளைக் கொண்டிருக்கக்கூடாது; பின்பற்றக்கூடிய ஒருங்கிணைப்புப் படிகளையும் ஆதாரமுள்ள பதில் எடுத்துக்காட்டுகளையும் மட்டுமே கொண்டிருக்க வேண்டும். `/api/public/consultation` அழைப்புக்கு, Request Registry-க்கு ஏற்ப உருவாக்கப்படுகிறது. Zentor அத்தகைய Key முறைமையை வழங்காததால், பொது Route-களுக்குப் பொதுவான Developer-API-Key தேவையில்லை. பாதுகாக்கப்பட்ட Widget Route-கள் மாறாக, ஒருமுறை மட்டுமே காட்டப்படும் Embed-Token-ஐயும் Origin சோதனையையும் பயன்படுத்துகின்றன. HTTP நிலையும் JSON உள்ளடக்கமும் சேர்த்து மதிப்பிடப்பட வேண்டும்; `ok` புலம் மட்டும் பிழை கையாளுதலுக்கு மாற்று ஆகாது. `POST /api/public/consultation`-ஐச் சோதிக்கும்போது அநாமதேயமாக்கப்பட்ட மதிப்புகளைப் பயன்படுத்த வேண்டும். உண்மையான வாடிக்கையாளர் தரவு, தயாரிப்புச் சூழலின் UUID-கள், Session-Token-கள் மற்றும் குறிப்பிட்ட நேரமுத்திரைகள் பொது எடுத்துக்காட்டுகளில் இடம்பெறக்கூடாது. அறியப்பட்ட தளம் முழுவதுக்குமான வரம்பு 15 நிமிடங்களுக்குள் 2,000 கோரிக்கைகள்; வேறுபட்ட தனி வரம்பு உறுதிப்படுத்தப்படவில்லை. Idempotent அல்லாத POST அழைப்புகளை, நெட்வொர்க் துண்டிப்பு தெளிவாகத் தெரியாதபோது, கண்மூடித்தனமாக மீண்டும் அனுப்பக்கூடாது. இந்த Route-க்கான வழக்கமான ஒருங்கிணைப்புப் பிழைகள் கட்டாய அளவுருக்கள் இல்லாதது, தவறான தரவு வகைகள், காலாவதியான ஒருமுறைக் குறியீடுகள், அனுமதிக்கப்படாத Origin-கள் அல்லது முன்பே இல்லாத தரவுப் பதிவு ஆகியவற்றால் ஏற்படுகின்றன. பயன்பாடு இத்தகைய நிலைகளைத் தனித்தனியாகக் கையாள வேண்டும்; முனைப்புள்ளி திருப்பியனுப்பும் பிழைச் செய்தியை, ரகசிய உள்ளடக்கத்தை எழுதாமல், பதிவு செய்ய வேண்டும். வெற்றிகரமான Request இந்தச் செயலாக்கப் படியை மட்டுமே உறுதிப்படுத்துகிறது; பின்னடுத்த மின்னஞ்சல், கட்டணம் அல்லது SSO வெற்றியைத் தானாக உறுதிப்படுத்தாது. இது "POST /api/public/consultation"-க்கு நேரடியாகப் பொருத்தமானது. இந்தப் பக்கத்தின் தொழில்நுட்பச் சரிபார்ப்பு `app/frontend/src/content/api-reference/` கீழுள்ள Registry-யையும் தொடர்புடைய Backend Route-களையும் கட்டாயமாக அடிப்படையாகக் கொண்டிருக்க வேண்டும். Live-சோதனைக் குறிப்புகள் உண்மையில் சோதிக்கப்பட்டதை மட்டுமே கூற வேண்டும். எதிர்மறைச் சோதனையோ குறியீட்டு ஒப்புமையோ முழுமையான வெற்றிச் சான்று ஆகாது. எனவே POST /api/public/consultation — API குறிப்புக்கு, ஆவணப்படுத்தப்பட்ட கட்டமைப்பு, தானியங்கிச் சோதனை மற்றும் பாதுகாப்பாகக் கவனிக்கப்பட்ட Live நடத்தை ஆகியவற்றுக்கிடையே தெளிவாக வேறுபடுத்த வேண்டும்.

{"name":"Max Mustermann","email":"max@example.com","company":"Musterfirma","message":"தேவைகள்","consentGiven":true}

{"ok":true,"message":"உங்கள் ஆலோசனை கோரிக்கை சமர்ப்பிக்கப்பட்டது. விரைவில் உங்களைத் தொடர்பு கொள்வோம்."}