- HTTP অনুরোধ
- অনুরোধের মূল অংশ
- প্রতিক্রিয়া মূল অংশ
- প্রুফিং স্ট্যাটাস
- মুলতুবি
- গৃহীত
- প্রত্যাখ্যাত
- প্রত্যাখ্যান
- প্রমাণ অমিল
- প্রমাণ অসম্পূর্ণ
- নিম্ন ঝুঁকির স্কোর
- রেকর্ডনটফাউন্ড
- রেকর্ড অবৈধ
- সর্বোচ্চবিধান পৌঁছেছে
- ঝুঁকি যাচাই ব্যর্থতা
- লাইভনেসচেকফেইলর
- চ্যালেঞ্জ করা হয়েছে
- ভৌত অবস্থান পরিদর্শন
- ইস্যুকারীUrlভিজিট
- অতিরিক্ত সময় প্রয়োজন
- বাতিল করা হয়েছে
- প্রত্যাহার করা হয়েছে
- মেয়াদোত্তীর্ণ
একটি প্রুফিংয়ের বর্তমান অবস্থা পুনরুদ্ধারের জন্য একটি শেষ বিন্দু।
HTTP অনুরোধ
POST https://example.issuer.com/api/v1/vdc/getProofingStatus
অনুরোধের মূল অংশ
অনুরোধের মূল অংশে নিম্নলিখিত কাঠামো সহ ডেটা রয়েছে:
| JSON উপস্থাপনা |
|---|
{
"requestMetadata": {
object ( |
| ক্ষেত্র | |
|---|---|
requestMetadata | সমস্ত অনুরোধের ক্ষেত্রে প্রয়োজনীয় অনুরোধ সম্পর্কে মেটাডেটা। |
deviceReferenceId | ডিভাইসের সাথে সম্পর্কিত আইডি এবং ডিভাইসের সাথে সম্পর্কিত পরিচয় কী। এটি কোনও ডিভাইস আইডি নয়, অর্থাৎ যদি ব্যবহারকারীর একই ডিভাইসে দুটি পৃথক শংসাপত্র থাকে, তবে এই আইডি তাদের মধ্যে আলাদা হবে। এই আইডিটি সমস্ত অনুরোধে সরবরাহ করা হয় এবং অনুরোধগুলির সাথে সম্পর্ক স্থাপন করতে ব্যবহার করা যেতে পারে। |
proofingId | একটি অস্বচ্ছ শনাক্তকারী যা একটি নির্দিষ্ট ডিভাইসের জন্য প্রমাণের একটি নির্দিষ্ট বান্ডিল সহ একটি প্রুফিং প্রতিনিধিত্ব করে। যেমন: UUID |
প্রতিক্রিয়া মূল অংশ
একটি প্রুফিংয়ের বর্তমান অবস্থা সম্বলিত একটি প্রতিক্রিয়া।
যদি সফল হয়, তাহলে রেসপন্স বডিতে নিম্নলিখিত কাঠামো সহ ডেটা থাকবে:
| JSON উপস্থাপনা |
|---|
{ "responseMetadata": { object ( |
| ক্ষেত্র | |
|---|---|
responseMetadata | সমস্ত প্রতিক্রিয়ার জন্য প্রয়োজনীয় প্রতিক্রিয়া সম্পর্কে মেটাডেটা। |
proofingStatus | প্রুফিংয়ের বর্তমান অবস্থা। |
প্রুফিং স্ট্যাটাস
একটি প্রুফিংয়ের বিভিন্ন অবস্থা প্রতিনিধিত্বকারী একটি বস্তু।
| JSON উপস্থাপনা |
|---|
{ // Union field |
| ক্ষেত্র | |
|---|---|
ইউনিয়ন ক্ষেত্রের status । প্রুফিং স্ট্যাটাসের জন্য সম্ভাব্য বিভিন্ন স্ট্যাটাস ধারণকারী একটি status নিম্নলিখিতগুলির মধ্যে কেবল একটি হতে পারে: | |
pending | একটি বিচারাধীন অবস্থা, যা নির্দেশ করে যে ইস্যুকারী এখনও কোনও সিদ্ধান্ত নেননি। |
accepted | একটি স্বীকৃত অবস্থা, যা নির্দেশ করে যে ইস্যুকারী প্রুফিং গ্রহণ করেছেন। |
rejected | একটি প্রত্যাখ্যাত অবস্থা, যা নির্দেশ করে যে ইস্যুকারী প্রুফিং প্রত্যাখ্যান করেছেন। |
challenged | একটি চ্যালেঞ্জযুক্ত স্ট্যাটাস, যা নির্দেশ করে যে ইস্যুকারী চাইবেন যে ব্যবহারকারী ইস্যুকারীর দ্বারা প্রুফিংয়ের সিদ্ধান্ত নেওয়ার আগে একটি চ্যালেঞ্জ সম্পূর্ণ করুক। |
canceled | একটি বাতিল অবস্থা, যা নির্দেশ করে যে ব্যবহারকারী প্রুফিং বাতিল করেছেন। |
revoked | একটি প্রত্যাহারকৃত অবস্থা, যা নির্দেশ করে যে ইস্যুকারী প্রুফিং প্রত্যাহার করেছেন। |
expired | একটি মেয়াদোত্তীর্ণ অবস্থা, যা নির্দেশ করে যে ইস্যুকারী কর্তৃক নির্ধারিত সময়সীমার আগে প্রুফিং-এর কোনও সিদ্ধান্ত নেওয়া হয়নি (সম্ভবত কোনও চ্যালেঞ্জ সম্পন্ন না হওয়ার কারণে)। |
মুলতুবি
এই ধরণের কোনও ক্ষেত্র নেই।
একটি অবজেক্ট যা একটি মুলতুবি অবস্থা নির্দেশ করে। এই বার্তাটি ইচ্ছাকৃতভাবে এখন খালি। ভবিষ্যতে নতুন ক্ষেত্র যোগ করা হতে পারে।
গৃহীত
এই ধরণের কোনও ক্ষেত্র নেই।
একটি স্বীকৃত প্রুফিং স্ট্যাটাস প্রতিনিধিত্বকারী একটি বস্তু।
প্রত্যাখ্যাত
একটি প্রত্যাখ্যাত প্রমাণীকরণ অবস্থা প্রতিনিধিত্বকারী একটি বস্তু।
| JSON উপস্থাপনা |
|---|
{ "primaryRejection": { object ( |
| ক্ষেত্র | |
|---|---|
primaryRejection | এই প্রুফিং কেন প্রত্যাখ্যাত হয়েছে তার প্রাথমিক কারণ। |
additionalRejections[] | যদি থাকে, তাহলে প্রুফিং কেন প্রত্যাখ্যাত হয়েছে তার অতিরিক্ত কারণ। |
প্রত্যাখ্যান
একটি নির্দিষ্ট প্রত্যাখ্যানের কারণ সম্পর্কে বিশদ সম্বলিত একটি বস্তু, যা একটি প্রত্যাখ্যাত অবস্থা ধারণকারী প্রমাণীকরণের দিকে পরিচালিত করে।
| JSON উপস্থাপনা |
|---|
{ "rejectionDescription": string, "issuerRejectionIdentifier": string, // Union field |
| ক্ষেত্র | |
|---|---|
rejectionDescription | ডিবাগ করার জন্য সাপোর্ট প্রতিনিধিদের এই প্রত্যাখ্যানের একটি বিবরণ। মনে রাখবেন এটি কখনই ব্যবহারকারীদের দেখানো হবে না। এতে ডিবাগিংয়ের জন্য ব্যবহৃত বর্ণনামূলক, অ-সংবেদনশীল টেক্সট থাকতে পারে। সতর্কতা: এই বার্তায় কোনও PII অন্তর্ভুক্ত করবেন না। |
issuerRejectionIdentifier | এই শনাক্তকারীটি ইস্যুকারীর জন্য নির্দিষ্ট এবং ইস্যুকারী দ্বারা তৈরি করা হয়। এটি শুধুমাত্র প্রত্যাখ্যান সনাক্ত করার জন্য ডিবাগিংয়ের উদ্দেশ্যে ব্যবহৃত হয়। এটি সেই শনাক্তকারী যার মাধ্যমে ইস্যুকারী এই প্রত্যাখ্যানটি জানেন। |
ইউনিয়ন ক্ষেত্রের reason । প্রুফিং বাতিল হওয়ার বিভিন্ন কারণের মধ্যে একটি। reason নিম্নলিখিতগুলির মধ্যে কেবল একটি হতে পারে: | |
evidenceMismatch | প্রমাণের অমিলের কারণে প্রুফিং বাতিল করা হয়েছে তা নির্দেশ করে। ব্যবহারের উদাহরণ: - ইস্যুকারীর সিস্টেমে অ্যাপ ক্যাপচার করা সেলফি এবং ছবির মিল নেই। - ইস্যুকারীর সিস্টেমে অ্যাপ ক্যাপচার করা ডকুমেন্টের ছবি এবং ছবির মিল নেই। |
evidenceIncomplete | অসম্পূর্ণ প্রমাণের কারণে প্রমাণীকরণ প্রত্যাখ্যান করা হয়েছে তা নির্দেশ করে। ব্যবহারের উদাহরণ: - ইস্যুকারীর দ্বারা প্রয়োজনীয় সমস্ত প্রমাণ গৃহীত হয়নি। |
lowRiskScore | (অবঞ্চিত: riskCheckFailure অথবা livenessCheckFailure সেই অনুযায়ী ব্যবহার করুন) কম ঝুঁকি স্কোরের কারণে প্রুফিং বাতিল করা হয়েছে তা নির্দেশ করে। ব্যবহারের উদাহরণ: - ওয়ালেটে প্রদত্ত ঝুঁকির স্কোর কম। - বারবার ব্যর্থ প্রচেষ্টার কারণে ইস্যুকারী এই ব্যবহারকারীকে লক করে দিয়েছে। |
recordNotFound | ইঙ্গিত করে যে ইস্যুকারীর সিস্টেমে রেকর্ড না থাকার কারণে প্রুফিং বাতিল করা হয়েছে। ব্যবহারের উদাহরণ: - ইস্যুকারীর সিস্টেমে রেকর্ডটি পাওয়া যায় না। - একটি নির্দিষ্ট রেকর্ড অপ্ট আউট করা হয়। |
recordInvalid | ইঙ্গিত করে যে ইস্যুকারীর সিস্টেমে রেকর্ডটি অবৈধ অবস্থায় থাকার কারণে প্রুফিং প্রত্যাখ্যান করা হয়েছিল। ব্যবহারের উদাহরণ: - রেকর্ডটি বাতিল অবস্থায় আছে। - রেকর্ডটির মেয়াদ শেষ হয়ে গেছে। |
maxProvisioningsReached | নির্দেশ করে যে ডকুমেন্টে সর্বাধিক সংখ্যক ডিভাইস অনুমোদিত থাকার কারণে প্রুফিং বাতিল করা হয়েছে। |
riskCheckFailure | ঝুঁকি স্কোর পরীক্ষা ব্যর্থতার কারণে প্রুফিং প্রত্যাখ্যান করা হয়েছে তা নির্দেশ করে। ব্যবহারের উদাহরণ: - প্রদত্ত ওয়ালেটের ঝুঁকি স্কোর উচ্চ, যা জালিয়াতির উচ্চ ঝুঁকির প্রতিনিধিত্ব করে। - ইস্যুকারী মূল্যায়ন করে যে অনুরোধটিতে জালিয়াতির উচ্চ ঝুঁকি রয়েছে। |
livenessCheckFailure | ইঙ্গিত করে যে জীবন্ততা পরীক্ষা ব্যর্থতার কারণে প্রুফিং প্রত্যাখ্যান করা হয়েছে। ব্যবহারের উদাহরণ: - ওয়ালেটে প্রদত্ত লাইভনেস স্কোর কম। |
প্রমাণ অমিল
একটি বস্তু যা প্রমাণের অমিল প্রত্যাখ্যান নির্দেশ করে।
| JSON উপস্থাপনা |
|---|
{ "evidenceType": string } |
| ক্ষেত্র | |
|---|---|
evidenceType | অমিল প্রমাণের একটি বিবরণ। শুধুমাত্র ডিবাগের উদ্দেশ্যে ব্যবহৃত। |
প্রমাণ অসম্পূর্ণ
একটি বস্তু যা প্রমাণ অসম্পূর্ণ প্রত্যাখ্যান নির্দেশ করে।
| JSON উপস্থাপনা |
|---|
{ "evidenceType": string } |
| ক্ষেত্র | |
|---|---|
evidenceType | অসম্পূর্ণ প্রমাণের একটি বিবরণ। শুধুমাত্র ডিবাগের উদ্দেশ্যে ব্যবহৃত। |
নিম্ন ঝুঁকির স্কোর
এই ধরণের কোনও ক্ষেত্র নেই।
একটি অবজেক্ট যা কম ঝুঁকিপূর্ণ স্কোর প্রত্যাখ্যানের ইঙ্গিত দিচ্ছে। এই বার্তাটি এখন ইচ্ছাকৃতভাবে খালি। ভবিষ্যতে নতুন ক্ষেত্র যোগ করা হতে পারে।
রেকর্ডনটফাউন্ড
এই ধরণের কোনও ক্ষেত্র নেই।
একটি অবজেক্ট যা একটি রেকর্ড খুঁজে না পাওয়া প্রত্যাখ্যানের ইঙ্গিত দিচ্ছে। এই বার্তাটি ইচ্ছাকৃতভাবে এখন খালি। ভবিষ্যতে নতুন ক্ষেত্র যোগ করা হতে পারে।
রেকর্ড অবৈধ
একটি অবজেক্ট যা একটি অবৈধ রেকর্ড প্রত্যাখ্যান নির্দেশ করে।
| JSON উপস্থাপনা |
|---|
{ "invalidityReason": string } |
| ক্ষেত্র | |
|---|---|
invalidityReason | রেকর্ডটি কেন অবৈধ তার একটি বর্ণনা। |
সর্বোচ্চবিধান পৌঁছেছে
একটি অবজেক্ট যা সর্বোচ্চ প্রভিশনিং প্রত্যাখ্যানে পৌঁছেছে তা নির্দেশ করে।
| JSON উপস্থাপনা |
|---|
{ "maxNumberOfProvisioningsAllowed": integer } |
| ক্ষেত্র | |
|---|---|
maxNumberOfProvisioningsAllowed | ইস্যুকারীর নীতি অনুসারে অনুমোদিত সর্বোচ্চ কতগুলি প্রভিশনিং নির্ধারিত হবে। |
ঝুঁকি যাচাই ব্যর্থতা
এই ধরণের কোনও ক্ষেত্র নেই।
ঝুঁকি পরীক্ষা ব্যর্থতা প্রত্যাখ্যানের ইঙ্গিত দিচ্ছে এমন একটি বস্তু। এই বার্তাটি এখন ইচ্ছাকৃতভাবে খালি। ভবিষ্যতে নতুন ক্ষেত্র যোগ করা হতে পারে।
লাইভনেসচেকফেইলর
এই ধরণের কোনও ক্ষেত্র নেই।
একটি অবজেক্ট যা লাইভনেস চেক ব্যর্থতা প্রত্যাখ্যানের ইঙ্গিত দিচ্ছে। এই বার্তাটি এখন ইচ্ছাকৃতভাবে খালি। ভবিষ্যতে নতুন ক্ষেত্র যোগ করা হতে পারে।
চ্যালেঞ্জ করা হয়েছে
একটি চ্যালেঞ্জযুক্ত প্রুফিং স্ট্যাটাস প্রতিনিধিত্বকারী একটি বস্তু।
| JSON উপস্থাপনা |
|---|
{ "challengeDescription": string, // Union field |
| ক্ষেত্র | |
|---|---|
challengeDescription | সাপোর্ট প্রতিনিধিদের ডিবাগ করার চ্যালেঞ্জের বর্ণনা। মনে রাখবেন এটি কখনই ব্যবহারকারীদের দেখানো হয় না। এতে ডিবাগিংয়ের জন্য ব্যবহৃত বর্ণনামূলক, অ-সংবেদনশীল টেক্সট থাকতে পারে। সতর্কতা: এই বার্তায় কোনও PII অন্তর্ভুক্ত করবেন না। |
ইউনিয়ন ফিল্ড challenge । ব্যবহারকারীকে যে বিভিন্ন চ্যালেঞ্জগুলি সম্পূর্ণ করতে হতে পারে তার মধ্যে একটি। challenge নিম্নলিখিতগুলির মধ্যে কেবল একটি হতে পারে: | |
physicalLocationVisit | এমন একটি চ্যালেঞ্জ যেখানে একজন ব্যবহারকারীকে একটি চ্যালেঞ্জ সম্পূর্ণ করার জন্য কোনও বাস্তব স্থানে, যেমন ইস্যুকারীর অফিসে যেতে হয়। |
issuerUrlVisit | একটি চ্যালেঞ্জ বিকল্প যেখানে ব্যবহারকারীকে ইস্যুকারীর দ্বারা প্রদত্ত একটি URL পরিদর্শন করতে হবে এবং সেই URL এ একটি চ্যালেঞ্জ সম্পূর্ণ করতে হবে। |
additionalTimeRequired | একটি চ্যালেঞ্জ বিকল্প যেখানে এই প্রুফিং পর্যালোচনা করার জন্য আরও কিছু সময় প্রয়োজন। |
ভৌত অবস্থান পরিদর্শন
এই ধরণের কোনও ক্ষেত্র নেই।
একটি অবজেক্ট যা চ্যালেঞ্জ অপশনের প্রতিনিধিত্ব করে যেখানে একজন ব্যবহারকারীকে একটি চ্যালেঞ্জ সম্পূর্ণ করার জন্য একটি বাস্তব অবস্থান, যেমন ইস্যুকারীর অফিসে যেতে হয়। এই চ্যালেঞ্জটি গুগলের বাইরে। নিরাপত্তার কারণে, যদি ইস্যুকারী এই ধরণের চ্যালেঞ্জ সমর্থন করে, তাহলে অনবোর্ডিংয়ের সময় তাদের অবশ্যই গুগলকে অবস্থানের বিবরণ প্রদান করতে হবে।
ইস্যুকারীUrlভিজিট
এই ধরণের কোনও ক্ষেত্র নেই।
একটি অবজেক্ট যা চ্যালেঞ্জ অপশনের প্রতিনিধিত্ব করে যেখানে ব্যবহারকারীকে ইস্যুকারীর দ্বারা প্রদত্ত একটি URL পরিদর্শন করতে হবে এবং সেই URL এ একটি চ্যালেঞ্জ সম্পূর্ণ করতে হবে। এই চ্যালেঞ্জটি Google এর ব্যান্ডের বাইরে। নিরাপত্তার কারণে, যদি ইস্যুকারী এই ধরণের চ্যালেঞ্জ সমর্থন করে, তাহলে অনবোর্ডিংয়ের সময় তাদের Google কে URL প্রদান করতে হবে।
অতিরিক্ত সময় প্রয়োজন
চ্যালেঞ্জ বিকল্পের প্রতিনিধিত্বকারী একটি বস্তু যেখানে প্রুফিং পর্যালোচনা করার জন্য অতিরিক্ত সময় প্রয়োজন। আনুমানিক সমাপ্তির সময় ঐচ্ছিকভাবে প্রদান করা যেতে পারে।
| JSON উপস্থাপনা |
|---|
{ "estimatedCompletion": string } |
| ক্ষেত্র | |
|---|---|
estimatedCompletion | আনুমানিক যে সময়ে প্রুফিং সম্পন্ন হবে। উপলব্ধ থাকলে পর্যালোচনা। ফর্ম্যাটটি একটি টাইমস্ট্যাম্প এবং টাইমস্ট্যাম্পটি ইউনিক্স যুগের পর থেকে মিলিসেকেন্ডের সংখ্যা হিসাবে উপস্থাপিত হয়। |
বাতিল করা হয়েছে
এই ধরণের কোনও ক্ষেত্র নেই।
একটি অবজেক্ট যা বাতিল প্রুফিং স্ট্যাটাস উপস্থাপন করছে। এই বার্তাটি ইচ্ছাকৃতভাবে এখন খালি। ভবিষ্যতে নতুন ক্ষেত্র যোগ করা হতে পারে।
প্রত্যাহার করা হয়েছে
এই ধরণের কোনও ক্ষেত্র নেই।
একটি অবজেক্ট যা প্রত্যাহারকৃত প্রুফিং স্ট্যাটাস উপস্থাপন করছে। এই বার্তাটি ইচ্ছাকৃতভাবে এখন খালি। ভবিষ্যতে নতুন ক্ষেত্র যোগ করা হতে পারে।
মেয়াদোত্তীর্ণ
এই ধরণের কোনও ক্ষেত্র নেই।
একটি অবজেক্ট যা মেয়াদোত্তীর্ণ প্রুফিং স্ট্যাটাস উপস্থাপন করছে। এই বার্তাটি ইচ্ছাকৃতভাবে এখন খালি। ভবিষ্যতে নতুন ক্ষেত্র যোগ করা হতে পারে।