POST/api/public/contact
Zentor ওয়েবসাইটের সর্বজনীন যোগাযোগ ফর্ম। অভ্যন্তরীণ লিড-সিস্টেমে একটি অনুরোধ তৈরি করে।
`POST /api/public/contact` Zentor ওয়েবসাইটের পাবলিক কন্টাক্ট ফর্ম প্রক্রিয়া করে এবং অভ্যন্তরীণ লিড-সিস্টেমে অনুরোধটি জমা দেয়। এন্ডপয়েন্টটির জন্য ড্যাশবোর্ড প্রমাণীকরণের প্রয়োজন নেই এবং এটি আইডেম্পোটেন্ট নয়। প্রতিটি সফল জমা একটি নতুন লিড তৈরি করতে পারে। তাই ফ্রন্টএন্ডের উচিত প্রথম ক্লিকের পরে সেন্ড বাটনটি নিষ্ক্রিয় করা এবং স্বয়ংক্রিয় পুনরাবৃত্তি ট্রিগার না করা। নিশ্চিত বাধ্যতামূলক ক্ষেত্রগুলির মধ্যে রয়েছে `name`, `email` এবং `message`। নামের দৈর্ঘ্য ২ থেকে ১২০ অক্ষরের মধ্যে হতে হবে, ইমেল ঠিকানাটি একটি বৈধ ফরম্যাটের হতে হবে এবং বার্তাটি সার্ভার-সাইড বৈধকরণের নিয়ম পূরণ করতে হবে। অতিরিক্ত ক্ষেত্রগুলি কেবল তখনই পাঠানো উচিত যদি সেগুলি প্রকৃত স্কিমায় অন্তর্ভুক্ত থাকে। অভ্যন্তরীণ লিডের বৈশিষ্ট্যগুলি নিয়ন্ত্রণ করতে অজানা মান ব্যবহার করা উচিত নয়। একটি সঠিক ফর্ম ব্রাউজারেই বাধ্যতামূলক ক্ষেত্রগুলি পরীক্ষা করে, তবে শুধুমাত্র এই পরীক্ষার উপর নির্ভর করে না। সার্ভারই চূড়ান্ত কর্তৃপক্ষ। বৈধকরণ ত্রুটির ক্ষেত্রে ইন্টারফেসের উচিত প্রভাবিত ক্ষেত্রটি চিহ্নিত করা এবং প্রবেশ করানো বিষয়বস্তু সংরক্ষণ করা। একটি সাধারণ সাফল্যের বার্তা কেবলমাত্র সার্ভারের ইতিবাচক প্রতিক্রিয়ার পরে প্রদর্শিত হওয়া উচিত। কন্টাক্ট ফর্মটি পাসওয়ার্ড, API কী, উইজেট টোকেন, পেমেন্ট ডেটা বা সম্পূর্ণ কাস্টমার রেকর্ডের জন্য নিরাপদ চ্যানেল নয়। ব্যবহারকারীদের উচিত ব্যবহারের ক্ষেত্র, প্রভাবিত পণ্য এবং একটি যোগাযোগযোগ্য ব্যবসায়িক ইমেল ঠিকানা উল্লেখ করা। প্রযুক্তিগত সমস্যার ক্ষেত্রে টেন্যান্টের নাম, সময়, প্রভাবিত ফাংশন এবং পুনরুত্পাদনযোগ্য ধাপগুলি সাহায্য করে, অপ্রয়োজনীয় ব্যক্তিগত বিষয়বস্তু প্রেরণ না করে। একটি বাস্তবসম্মত প্রক্রিয়া: দর্শক নাম, ইমেল এবং বার্তা পূরণ করে, প্রয়োজনে পৃষ্ঠার গোপনীয়তা বিজ্ঞপ্তিগুলি নিশ্চিত করে এবং ফর্মটি পাঠায়। সার্ভার ডেটা বৈধ করে, লিড তৈরি করে এবং একটি সাফল্যের প্রতিক্রিয়া দেয়। অবৈধ ইমেল বা খুব ছোট নামের ক্ষেত্রে সম্পূর্ণ লিড তৈরি হয় না। এন্ডপয়েন্টটি কোনো টেন্যান্ট তৈরি করে না, কোনো প্যাকেজ বুক করে না এবং কাঠামোগত পণ্য কনফিগারেশন বা পরামর্শ প্রক্রিয়া প্রতিস্থাপন করে না। স্প্যাম এবং স্বয়ংক্রিয় সিরিয়াল অনুরোধ থেকে সুরক্ষার জন্য ক্লায়েন্টের উচিত সার্ভার-সাইড ত্রুটিগুলি সম্মান করা এবং তাৎক্ষণিক অসীম লুপ শুরু না করা। একটি সফল প্রতিক্রিয়া সার্ভার গ্রহণ নিশ্চিত করার পরেই ইনপুট ক্ষেত্রগুলি খালি করা উচিত। প্রতিক্রিয়া না এলে ব্যবহারকারী বিষয়বস্তু সংরক্ষণ করতে পারে এবং পরে নিয়ন্ত্রিতভাবে আবার পাঠাতে পারে। অভ্যন্তরীণ শ্রেণিবিভাগের জন্য বার্তায় প্রকৃত কারণ থাকা উচিত, বিপণন বাক্য বা গোপনীয় সংযুক্তি ছাড়া। একটি স্পষ্ট বিষয় এবং সুনির্দিষ্ট সমস্যার বিবরণ জিজ্ঞাসা কমিয়ে দেয়। তবে API নিজে কোনো নিশ্চিত অগ্রাধিকার দেয় না এবং কোনো নির্দিষ্ট প্রক্রিয়াকরণের সময়সীমা নিশ্চিত করে না।
Auth & Absicherung
Keine Authentifizierung erforderlich
Idempotent: Nein
Parameter
name(body, string, erforderlich)— ২–১২০ অক্ষরemail(body, string, erforderlich)— বৈধ ইমেইল ঠিকানাmessage(body, string, erforderlich)— ১০–৩০০০ অক্ষরcompany(body, string)phone(body, string)topic(body, string)consentGiven(body, boolean, erforderlich)— সত্য হতে হবে (ডেটা সুরক্ষা সম্মতি)Beispiel-Request
{"name":"ম্যাক্স মুস্টারম্যান","email":"max@example.com","message":"আপনার বার্তা (কমপক্ষে 10 অক্ষর)","consentGiven":true}Beispiel-Response
{"ok":true,"message":"আপনার অনুরোধটি প্রেরণ করা হয়েছে।"}Fehlercodes
400 VALIDATION_ERROR — বাধ্যতামূলক ক্ষেত্র অনুপস্থিত/অবৈধ, অথবা ডেটা সুরক্ষা সম্মতি অনুপস্থিত (Details-Array পৃথক ত্রুটি বার্তাসহ)।Live-Test-Nachweis
সাফল্য (200) এবং নেতিবাচক ক্ষেত্রে (400, অনুপস্থিত ক্ষেত্র সহ অনুপস্থিত সম্মতি) লাইভ যাচাই করা হয়েছে।