POST/api/public/contact
Zentor இணையதளத்தின் பொதுவான தொடர்பு வடிவம். இது உள்ளூர் லீட் முறையில் ஒரு கோரிக்கையை உருவாக்குகிறது.
`POST /api/public/contact` சமூகத் தொடர்பு வடிவத்தின் பொதுவானதை செயலாக்குகிறது Zentor-இணையதளம் மற்றும் உள்ளுறை லீட்-அமைப்பில் கோரிக்கையைப் பதிவு செய்கிறது. இறுதிப் புள்ளி டாஷ்போர்ட் அங்கீகாரத்தைத் தேவையாகக் கொள்ளாது மற்றும் ஐடிம்பாடெண்ட் அல்ல. ஒவ்வொரு வெற்றிகரமான அனுப்பலும் ஒரு புதிய லீட்டை உருவாக்கலாம். எனவே, முன்னணி அளவுகோல் முதல் கிளிக் பிறகு அனுப்பும் பொத்தானைத் தடைசெய்ய வேண்டும் மற்றும் தானியங்கி மீள்தொடர்புகளைத் தூண்டக்கூடாது. உறுதிப்படுத்தப்பட்ட கட்டாயப் புலங்கள் `name`, `email` மற்றும் `message` ஆகும். பெயர் 2 மற்றும் 120 மின்னஞ்சல் முகவரி குறியீடுகளின் எண்ணிக்கை, அது செல்லுபடியாகும் வடிவத்தைக் கொண்டிருக்க வேண்டும், மற்றும் செய்தி சர்வர் பக்கச் சரிபார்ப்பு விதிகளைப் பூர்த்தி செய்ய வேண்டும். கூடுதல் புலங்கள், அவை உண்மையான அமைப்பில் உள்ளன என்றால் மட்டுமே அனுப்பப்பட வேண்டும். உள்நாட்டுத் தன்மைகளைக் கட்டுப்படுத்த அறியப்படாத மதிப்புகளைப் பயன்படுத்தக்கூடாது. சரியான வடிவம் கட்டாயப் புலங்களைப் பிரபஞ்சத்தில் சரிபார்க்கிறது, ஆனால் அந்தச் சரிபார்ப்பை மட்டும் நம்பாது. சர்வர் முக்கியமானது. ஒரு சரிபார்ப்புப் பிழை ஏற்பட்டால், மேலோட்டம் பாதிக்கப்பட்ட புலத்தைக் குறிக்க வேண்டும் மற்றும் உள்ளிட்டுள்ள உள்ளடக்கங்களைப் பாதுகாக்க வேண்டும். பொதுவான வெற்றிச் செய்தி, நேர்மறையான சர்வர் பதிலுக்குப் பிறகு மட்டுமே தோன்ற வேண்டும். தொடர்பு வடிவம் கடவுச்சொற்களுக்கான பாதுகாப்பான சேனல் அல்ல., API-கீ, விட்ஜெட்-டோக்கன்கள், கட்டணத் தரவுகள் அல்லது முழுமையான வாடிக்கையாளர் தரவுத் தொகுப்புகள். பயனர்கள் பயன்பாட்டு நிலப்பரப்பு, பாதிக்கப்பட்ட பொருட்பெயர் மற்றும் தொடர்புடைய வணிக மின்னஞ்சல் முகவரியைக் குறிப்பிட வேண்டும். தொழில்நுட்பக் காரணங்களுக்காக, குத்தகைதாரர் பெயர், நேரம், பாதிக்கப்பட்ட செயல்பாடு மற்றும் மீண்டும் செய்யக்கூடிய படிநிலைகள் போன்றவற்றை வழங்குவது, தேவையற்ற தனிப்பட்ட தரவுகளைப் பரப்பாமல் உதவும். ஒரு நடைமுறைச் செயல்முறை: பார்வையாளர் பெயர், மின்னஞ்சல் முகவரி மற்றும் செய்தியை நிரப்பி, தளத்தின் தரவுப் பாதுகாப்பு விளக்கங்களைத் தேவைப்பட்டால் உறுதிப்படுத்தி, வடிவத்தை அனுப்புகிறார். சர்வர் தரவுகளைச் சரிபார்க்கிறது, லீடை உருவாக்கி, வெற்றிக் கருவினை வழங்குகிறது. தவறான மின்னஞ்சல் முகவரி அல்லது மிகக் குறைந்த பெயர் இருந்தால், முழுமையான லீடு உருவாக்கப்படாது. முடிவுப்புள்ளி குத்தகைதாரரை உருவாக்காது, தொகுப்பை எடுக்காது, அல்லது அமைக்கப்பட்ட பொருட்பெயர் அமைப்பை அல்லது ஆலோசனைச் செயல்முறையைப் பதிலிடாது. ஸ்பாம் மற்றும் தானியங்கித் தொடர் வினவல்களிலிருந்து பாதுகாக்க, கிளையன்ட் சர்வர்-புறக் கோளாறுகளைப் பின்பற்ற வேண்டும் மற்றும் உடனடி முடிவிலா வட்டங்களைத் தொடங்கக்கூடாது. வெற்றிக் கருவி இருந்தால், சர்வர் ஏற்றுக்கொள்ளுதலை உறுதிப்படுத்திய பிறகு மட்டும் உள்ளீட்டுப் புலங்கள் காலியாக்கப்பட வேண்டும். கருவி வரவில்லை என்றால், பயனர் உள்ளடக்கத்தைப் பாதுகாத்து, பின்னர் கட்டுப்பாட்டில் மீண்டும் அனுப்பலாம். உள்ளுறை ஒப்பீட்டிற்காக, செய்தி உண்மையான காரணத்தைக் கொண்டிருக்க வேண்டும், விளம்பர வார்த்தைகள் அல்லது நம்பிக்கையான அணுகுமுறைகளைத் தவிர்த்து. தெளிவான தலைப்பு மற்றும் துல்லியமான பிரச்சனை விளக்கம் கேள்விகளைக் குறைக்கும். API இது தானாகவே ஒதுக்குகிறது, ஆனால் உறுதிப்படுத்தப்பட்ட முன்னுரிமையை அளிக்காது; நிலையான செயலாக்க காலத்தை உறுதிப்படுத்தாது..
அங்கீகாரம் & பாதுகாப்பு
அங்கீகாரம் தேவையில்லை
Idempotent (மீண்டும் செய்தாலும் அதே விளைவு): இல்லை
அளவுருக்கள்
name(body, string, கட்டாயம்)— 2–120 எழுத்துக்கள்email(body, string, கட்டாயம்)— செல்லுபடியாகும் மின்னஞ்சல் முகவரிmessage(body, string, கட்டாயம்)— 10–3000 எழுத்துக்கள்company(body, string)phone(body, string)topic(body, string)consentGiven(body, boolean, கட்டாயம்)— true ஆக இருக்க வேண்டும் (தரவு பாதுகாப்பு ஒப்புதல்)எடுத்துக்காட்டுக் கோரிக்கை
{"name":"Max Mustermann","email":"max@example.com","message":"உங்கள் செய்தி (குறைந்தபட்சம் 10 எழுத்துக்கள்).","consentGiven":true}எடுத்துக்காட்டுப் பதில்
{"ok":true,"message":"உங்கள் கோரிக்கை சமர்ப்பிக்கப்பட்டது."}பிழைக் குறியீடுகள்
400 VALIDATION_ERROR — கட்டாயப் புலம் இல்லை/சரியில்லை அல்லது தரவு பாதுகாப்பு ஒப்புதல் இல்லை (ஒவ்வொரு பிழையும் உள்ள தனித்த விவரங்களின் அமைப்பு).நேரலைச் சோதனைச் சான்று
வெற்றி (200) மற்றும் எதிர்மறை நிலை (400, ஒப்புதல் இல்லாதது உட்பட விடுபட்ட புலங்கள்) நேரடியாகச் சரிபார்க்கப்பட்டன.