এই নথিটি ঠিকানা যাচাইকরণ API থেকে বিভিন্ন প্রতিক্রিয়া পরিচালনা করার জন্য একটি ঠিকানা যাচাইকরণ সিস্টেম তৈরির একটি প্রক্রিয়া বর্ণনা করে। কখন এবং কীভাবে আপনার গ্রাহকদের আরও তথ্যের জন্য প্রম্পট করতে হবে তা নির্ধারণ করার জন্য এপিআই প্রতিক্রিয়া কীভাবে ব্যাখ্যা করা যায় তা কভার করে।
সাধারণভাবে API প্রতিক্রিয়া নিম্নলিখিত উপায়গুলি নির্ধারণ করে যেগুলি আপনার সিস্টেমকে একটি ঠিকানা পরিচালনা করা উচিত:
- ফিক্স — ঠিকানায় উল্লেখযোগ্য সমস্যা থাকতে পারে।
আরও তথ্যের জন্য আপনার গ্রাহককে অনুরোধ করার কথা বিবেচনা করুন। - সাবপ্রিমিস যোগ করুন —ঠিকানায় একটি সাবপ্রিমাইজ অনুপস্থিত থাকতে পারে।
আপনার গ্রাহককে একটি ইউনিট নম্বর যোগ করার জন্য অনুরোধ করার কথা বিবেচনা করুন। - নিশ্চিত করুন — ঠিকানায় ছোটখাটো সমস্যা থাকতে পারে।
ঠিকানাটি সঠিক কিনা তা নিশ্চিত করার জন্য আপনার গ্রাহককে অনুরোধ করার কথা বিবেচনা করুন। - স্বীকার করুন করুন — ঠিকানায় সমস্যা নাও থাকতে পারে।
আপনার নিজের ঝুঁকিতে, আরও প্রম্পট না করে ঠিকানাটি ব্যবহার করার কথা বিবেচনা করুন।
মূল উদ্দেশ্য
এই নথিটি আপনাকে API প্রতিক্রিয়া সেরা বিশ্লেষণ করতে এবং সরবরাহ করা ঠিকানাগুলির সাথে পরবর্তী পদক্ষেপগুলি নির্ধারণ করতে আপনার সিস্টেমটি সংশোধন করতে সহায়তা করে৷ নিম্নলিখিত সিউডোকোড একটি সম্ভাব্য প্রবাহ চিত্রিত করে।
if (verdict.possibleNextAction == FIX)
Prompt the user to fix the address.
else if (verdict.possibleNextAction == CONFIRM_ADD_SUBPREMISES)
Prompt the user to add a unit number.
else if (verdict.possibleNextAction == CONFIRM)
Confirm with the user that the address is correct.
else
Continue with the address returned by the API.
সঠিক যুক্তি আপনার পরিস্থিতির উপর নির্ভর করে - আরও বিশদ বিবরণের জন্য আপনার বৈধতা যুক্তি কাস্টমাইজ করুন দেখুন।
সম্ভাব্য কর্মপ্রবাহ
নীচের সারণীটি সম্ভাব্য কার্যপ্রবাহগুলির সংক্ষিপ্ত বিবরণ দেয় যা আপনি API প্রতিক্রিয়ার উপর ভিত্তি করে আপনার গ্রাহককে প্রম্পট করতে প্রয়োগ করতে পারেন।
| আপনার সিস্টেম আচরণ | ||
|---|---|---|
| ঠিকানা ঠিক করুন |
| |
| সাবপ্রিমিস যোগ করুন |
| |
| ঠিকানা নিশ্চিত করুন |
| |
| ঠিকানা গ্রহণ করুন |
| |
আপনার বৈধতা যুক্তি কাস্টমাইজ করুন
আপনি যখন verdict.possibleNextAction ক্ষেত্র থেকে ফলাফলগুলি ব্যবহার করে আপনার সিস্টেম API প্রতিক্রিয়ার সাথে কীভাবে এগিয়ে যায় তা নির্ধারণ করতে পারেন, আপনি কাস্টম লজিক তৈরি করার কথাও বিবেচনা করতে পারেন, যেমন ব্যবসা-নির্দিষ্ট প্রয়োজনগুলি পরিচালনা করা।
এই বিভাগের উদ্দেশ্য হল আপনি কীভাবে আপনার গ্রাহককে প্রম্পট করতে চান তা নির্ধারণ করার জন্য API প্রতিক্রিয়া ব্যাখ্যা করার জন্য আপনি কীভাবে আপনার নিজস্ব কাস্টম যুক্তি বিকাশ করতে পারেন তা ব্যাখ্যা করা। আপনার কাস্টমাইজেশনের জন্য বিবেচনা করার জন্য এই বিভাগে ঝুঁকি স্তর এবং অতিরিক্ত API প্রতিক্রিয়া সংকেত কভার করে।
তাতে বলা হয়েছে, এমনকি যদি আপনি আপনার পরবর্তী পদক্ষেপগুলি সম্পর্কে সিদ্ধান্ত নেওয়ার জন্য শুধুমাত্র verdict.possibleNextAction উপর নির্ভর করেন, তবুও নীচে বর্ণিত অতিরিক্ত সংকেতগুলি আপনাকে ঠিকানার সম্ভাব্য সমস্যাগুলির বিশদ বিবরণ বুঝতে সাহায্য করতে পারে৷
ঝুঁকি সহনশীলতা
আপনার সিস্টেম ঠিকানা যাচাইকরণ API থেকে সংকেতগুলিতে কীভাবে সাড়া দেয় তা ডিজাইন করার সময়, নিম্নলিখিত সুপারিশগুলি আপনাকে আরও কার্যকর প্রতিক্রিয়া মডেল তৈরি করতে সহায়তা করতে পারে। যাইহোক, এইগুলি শুধুমাত্র সুপারিশ, তাই মনে রাখবেন যে আপনার বাস্তবায়ন আপনার ব্যবসার মডেল অনুসারে হওয়া উচিত।
| নির্দেশনা | বিস্তারিত | |
|---|---|---|
| ঝুঁকির স্তর | সংশোধনের জন্য অনুরোধ করা এবং প্রবেশ করা ঠিকানাটি গ্রহণ করার মধ্যে ভারসাম্য বজায় রাখার সময় আপনার পরিস্থিতির জন্য সহনশীলতার মাত্রা বিবেচনা করুন। | ঠিকানা যাচাইকরণ API বিভিন্ন ধরণের সংকেত প্রদান করে যা আপনি আপনার বৈধকরণ প্রক্রিয়াকে অপ্টিমাইজ করতে আপনার ঝুঁকির স্তরের সাথে অন্তর্ভুক্ত করতে পারেন। উদাহরণস্বরূপ, যদি একটি ঠিকানায় একটি অনিশ্চিত রাস্তার নম্বর থাকে, আপনি এখনও এটি গ্রহণ করতে পারেন৷ অন্যদিকে, যদি আপনার ব্যবসায়িক ক্রিয়াকলাপের জন্য আরও সঠিক ঠিকানার প্রয়োজন হয়, আপনি আপনার ব্যবহারকারীকে অনুরোধ করতে পারেন। একটি উদাহরণের জন্য যা যেকোনো একটি বিভাগে পড়তে পারে, অ্যাসেপ্ট অ্যাড্রেস-এ নন-ইউএস অপ্রমাণিত রাস্তার নম্বর দেখুন - উদাহরণ। |
| ঠিকানা গ্রহণ করুন | গ্রাহক প্রম্পটে সাড়া না দিলে আপনার সিস্টেমকে আসল এন্ট্রি গ্রহণ করার অনুমতি দেওয়া একটি ভাল অভ্যাস। | এই ক্ষেত্রে, গ্রাহক সিস্টেমে নেই এমন একটি ঠিকানা লিখতে পারে, যেমন নতুন নির্মাণের জন্য। |
ঝুঁকি-বিরুদ্ধ চেকআউট প্রবাহের উদাহরণ
আপনি যদি ব্যর্থ ডেলিভারির ঝুঁকি কমাতে চান, তাহলে আপনার গ্রাহকদের আরও প্রায়ই প্রম্পট করার জন্য আপনি আপনার যুক্তি কাস্টমাইজ করতে পারেন। উদাহরণস্বরূপ, মূল উদ্দেশ্য বিভাগে বর্ণিত যুক্তি ব্যবহার করার পরিবর্তে, আপনি নিম্নলিখিত যুক্তি ব্যবহার করতে পারেন।
if (verdict.possibleNextAction == FIX or verdict.validationGranularity
== OTHER or verdict.validationGranularity == ROUTE)
Prompt customer to fix their address.
else if (verdict.possibleNextAction == CONFIRM_ADD_SUBPREMISES)
Prompt customer to add a unit number.
else if (verdict.possibleNextAction == CONFIRM or verdict.validationGranularity
== PREMISE_PROXIMITY or verdict.hasSpellCorrectedComponents or
verdict.hasReplacedComponents or verdict.hasInferredComponents)
Prompt customer to confirm their address.
else
Proceed with the returned address.
কম ঘর্ষণ চেকআউট প্রবাহ উদাহরণ
আপনি যদি আপনার চেকআউট প্রবাহে ঘর্ষণ কমাতে চান, তাহলে আপনি আপনার গ্রাহকদের কম ঘন ঘন প্রম্পট করার জন্য আপনার যুক্তি কাস্টমাইজ করতে পারেন। উদাহরণস্বরূপ, মূল উদ্দেশ্য বিভাগে বর্ণিত যুক্তি ব্যবহার করার পরিবর্তে, আপনি নিম্নলিখিত যুক্তি ব্যবহার করতে পারেন।
if (verdict.possibleNextAction == FIX)
Prompt customer to fix their address.
else if (verdict.hasReplacedComponents)
Prompt customer to confirm their address.
else
Proceed with the returned address.
ফিক্স সংকেত
একটি ঠিকানা ঠিক করুন যখন ফলাফল স্পষ্টভাবে নির্দেশ করে যে ঠিকানাটি বিতরণযোগ্য নাও হতে পারে। তারপরে আপনার সিস্টেম গ্রাহককে প্রয়োজনীয় তথ্য প্রদানের জন্য অনুরোধ করতে পারে, তারপরে আপনি একটি বিতরণযোগ্য ঠিকানা পেতে আপনার ওয়ার্কফ্লো পুনরায় জারি করবেন।
ঠিকানা যাচাইকরণ এপিআই প্রতিক্রিয়ার নিম্নলিখিত ক্ষেত্রগুলি verdict.possibleNextAction ছাড়াও ব্যবহার করা যেতে পারে কোনও ঠিকানায় বড় সমস্যা আছে কিনা এবং সেই সমস্যাগুলি কী তা নির্ধারণ করতে।
| বৈধকরণ গ্রানুলারিটি | যখন একটি ঠিকানার জন্য বৈধতা গ্রানুলারিটি enum হয় OTHER , সম্ভবত ঠিকানাটি ভুল। |
|---|---|
| অনুপস্থিত উপাদান | যখন address.missingComponentTypes খালি না থাকে, তখন সম্ভবত ঠিকানাটিতে মূল তথ্য অনুপস্থিত থাকে। |
| সন্দেহজনক উপাদান | যখন একটি উপাদানের জন্য নিশ্চিতকরণ স্তরের enum UNCONFIRMED_AND_SUSPICIOUS হয়, তখন সম্ভবত উপাদানটি ভুল। |
| অমীমাংসিত উপাদান | একটি অমীমাংসিত টোকেন হল ইনপুটের একটি অংশ যা একটি ঠিকানার বৈধ অংশ হিসাবে স্বীকৃত নয়৷ |
| ইউএসপিএস ডিপিভি নিশ্চিতকরণ | যখন uspsData.dpvConfirmation হয় N , বা খালি, তখন ঠিকানার সাথে একটি সমস্যা হতে পারে। এই ক্ষেত্রটি শুধুমাত্র মার্কিন ঠিকানার জন্য উপলব্ধ। uspsData.dpvConfirmation এ আরও বিস্তারিত জানার জন্য, হ্যান্ডেল ইউনাইটেড স্টেটস অ্যাড্রেস দেখুন। |
CONFIRM_ADD_SUBPREMISES সংকেত (শুধুমাত্র US ঠিকানা)
আপনি আপনার গ্রাহককে ঠিকানা পর্যালোচনা করার জন্য অনুরোধ জানান এবং একটি ইউনিট নম্বর যোগ করার কথা বিবেচনা করুন যখন ঠিকানা যাচাইকরণ API প্রতিক্রিয়া নির্দেশ করে যে ঠিকানাটিতে একটি সাবপ্রিমিসেস অনুপস্থিত হতে পারে। এই ক্ষেত্রে, বিল্ডিংয়ের ঠিকানাটি সম্ভবত বৈধ, তবে আপনি আরও বেশি আত্মবিশ্বাস চান যে ফলাফলের ঠিকানাটি গ্রাহকের উদ্দেশ্য।
ঠিকানা যাচাইকরণ API প্রতিক্রিয়ার নিম্নলিখিত ক্ষেত্রগুলি verdict.possibleNextAction ছাড়াও ব্যবহার করা যেতে পারে যে কোনও ঠিকানা সম্ভবত একটি সাবপ্রিমিস অনুপস্থিত কিনা তা নির্ধারণ করতে।
Missing subpremise component | যখন address.missingComponentTypes ফিল্ডে subpremise একটি মান থাকে, যা নির্দেশ করে যে ঠিকানা থেকে একটি ইউনিট সংখ্যা অনুপস্থিত। |
|---|---|
| USPS DPV নিশ্চিতকরণ | যখন uspsData.dpvConfirmation S হয়, তার মানে ঠিকানাটির প্রাথমিক সংখ্যাটি USPS ডাটাবেসের একটি ঠিকানার সাথে মিলে গেছে। যাইহোক, ঠিকানায় একটি মাধ্যমিক নম্বরও থাকবে বলে আশা করা হয়েছিল। এই ক্ষেত্রটি শুধুমাত্র মার্কিন ঠিকানার জন্য উপলব্ধ। uspsData.dpvConfirmation এ আরও বিস্তারিত জানার জন্য, হ্যান্ডেল ইউনাইটেড স্টেটস অ্যাড্রেস দেখুন। |
সাবপ্রিমিস ঠিকানা উদাহরণ যোগ করুন
সংকেত নিশ্চিত করুন
আপনি একটি ঠিকানা নিশ্চিত করেন যখন রায় নির্দেশ করে যে ঠিকানা যাচাইকরণ API হয় অনুমান করেছে বা একটি বৈধ ঠিকানা তৈরি করার জন্য ঠিকানা উপাদানগুলিতে পরিবর্তন করেছে৷ এই ক্ষেত্রে, আপনার কাছে একটি ডেলিভারিযোগ্য ঠিকানা আছে, কিন্তু আপনি আরও বেশি আত্মবিশ্বাস পছন্দ করেন যে ফলাফলের ঠিকানাটি গ্রাহকের উদ্দেশ্য।
ঠিকানা যাচাইকরণ এপিআই প্রতিক্রিয়ার নিম্নলিখিত ক্ষেত্রগুলি verdict.possibleNextAction ছাড়াও ব্যবহার করা যেতে পারে ঠিকানায় ছোটখাটো সমস্যা আছে কিনা এবং সেই সমস্যাগুলি কী তা নির্ধারণ করতে।
| বৈধকরণ গ্রানুলারিটি | যখন একটি ঠিকানার জন্য validationGranularity ROUTE বা PREMISE_PROXIMITY হয়, তখন ঠিকানাটি ভুল হতে পারে। |
|---|---|
| অনুমানকৃত তথ্য | যখন hasInferredComponents ক্ষেত্রটি true হয়, তখন আপনি জানেন যে API তথ্যে ভরা এটি অন্যান্য ঠিকানা উপাদান থেকে সংগ্রহ করেছে। |
| প্রতিস্থাপিত ডেটা | যখন hasReplacedComponents ক্ষেত্রটি true হয়, তখন API ঠিকানাটিকে বৈধ বলে মনে করা ডেটা দিয়ে প্রবেশ করা ডেটা প্রতিস্থাপন করে। |
| বানান সংশোধন | যখন hasSpellCorrectedComponents ক্ষেত্রটি true হয়, তখন API কিছু ভুল বানান উপাদানের বানান সংশোধন করে। |
সংকেত গ্রহণ করুন
আপনি একটি ঠিকানা গ্রহণ করতে পারেন যখন ঠিকানা যাচাইকরণ API API প্রতিক্রিয়া উচ্চ মাত্রার আত্মবিশ্বাস প্রদান করে যে ঠিকানাটি বিতরণযোগ্য এবং ডাউনস্ট্রিম প্রক্রিয়ায় গ্রাহকের সাথে যোগাযোগ ছাড়াই ব্যবহার করা যেতে পারে।
ঠিকানা বৈধতা API প্রতিক্রিয়ার নিম্নলিখিত ক্ষেত্রগুলি verdict.possibleNextAction ছাড়াও ব্যবহার করা যেতে পারে ঠিকানাটি গ্রহণযোগ্য মানের কিনা তা নির্ধারণ করতে।
| বৈধকরণ গ্রানুলারিটি | PREMISE এর একটি validationGranularity প্রায়ই গ্রহণযোগ্য, যদিও ROUTE এর মান এখনও একটি বিতরণযোগ্য ঠিকানা নির্দেশ করতে পারে। |
|---|---|
| কোন অনুমান করা তথ্য | যখন hasInferredComponents ক্ষেত্র false হয়, আপনি জানেন যে আউটপুটে কোন উপাদান অনুমান করা হয়নি। |
| কোনও প্রতিস্থাপিত ডেটা নেই | যখন hasReplacedComponents ক্ষেত্র false হয়, আপনি জানেন যে কোন ইনপুট ডেটা প্রতিস্থাপন করা হয়নি। |
| কোনো বানান সংশোধন নেই | যখন hasSpellCorrectedComponents ক্ষেত্র false হয়, আপনি জানেন যে কোন বানান সংশোধন করা হয়নি। |
| ইউএসপিএস ডিপিভি নিশ্চিতকরণ | যখন uspsData.dpvConfirmation Y হয়, তার মানে ঠিকানাটি USPS ডাটাবেসের একটি ঠিকানার সাথে মিলে গেছে। এই ক্ষেত্রটি শুধুমাত্র মার্কিন ঠিকানার জন্য উপলব্ধ। uspsData.dpvConfirmation এ আরও বিস্তারিত জানার জন্য, হ্যান্ডেল ইউনাইটেড স্টেটস অ্যাড্রেস দেখুন। |