Method: vdc.getProofingStatus

কোনো প্রুফিংয়ের বর্তমান অবস্থা জানার একটি এন্ডপয়েন্ট।

HTTP অনুরোধ

POST https://example.issuer.com/api/v1/vdc/getProofingStatus

অনুরোধকারী শরীর

অনুরোধের মূল অংশে নিম্নলিখিত কাঠামোসহ ডেটা থাকে:

JSON উপস্থাপনা 
{
  "requestMetadata": {
    object (RequestMetadata)
  },
  "deviceReferenceId": string,
  "proofingId": string
}
ক্ষেত্র
requestMetadata

object ( RequestMetadata )

আবশ্যক। অনুরোধ সম্পর্কিত মেটাডেটা, যা সকল অনুরোধের জন্য আবশ্যক।

deviceReferenceId

string

আবশ্যক। ডিভাইসটির সাথে সংশ্লিষ্ট আইডি এবং ডিভাইসটির সাথে যুক্ত আইডেন্টিটি কী। এটি কোনো ডিভাইস আইডি নয়, অর্থাৎ, যদি ব্যবহারকারীর একই ডিভাইসে দুটি আলাদা ক্রেডেনশিয়াল থাকে, তবে সেগুলোর মধ্যে এই আইডি ভিন্ন হবে।

এই আইডিটি সমস্ত অনুরোধে সরবরাহ করা হয় এবং অনুরোধগুলির মধ্যে সম্পর্ক স্থাপন করতে এটি ব্যবহার করা যেতে পারে।

proofingId

string

প্রয়োজনীয়। একটি নির্দিষ্ট ডিভাইসের জন্য, নির্দিষ্ট প্রমাণগুচ্ছ দ্বারা যাচাইকরণকে প্রতিনিধিত্বকারী একটি অস্বচ্ছ শনাক্তকারী।

উদাহরণ: UUID

প্রতিক্রিয়া সংস্থা

একটি প্রতিক্রিয়া, যাতে প্রুফিংয়ের বর্তমান অবস্থা উল্লেখ থাকে।

সফল হলে, প্রতিক্রিয়া অংশে নিম্নলিখিত কাঠামোসহ ডেটা থাকে:

JSON উপস্থাপনা 
{
  "responseMetadata": {
    object (ResponseMetadata)
  },
  "proofingStatus": {
    object (ProofingStatus)
  }
}
ক্ষেত্র
responseMetadata

object ( ResponseMetadata )

আবশ্যক। প্রতিক্রিয়া সম্পর্কিত মেটাডেটা, যা সকল প্রতিক্রিয়ার জন্য আবশ্যক।

proofingStatus

object ( ProofingStatus )

প্রয়োজনীয়। প্রুফিংয়ের বর্তমান অবস্থা।

প্রুফিং স্ট্যাটাস

একটি বস্তু যা একটি প্রুফিংয়ের বিভিন্ন অবস্থাকে উপস্থাপন করে।

JSON উপস্থাপনা 
{

  // Union field status can be only one of the following:
  "pending": {
    object (Pending)
  },
  "accepted": {
    object (Accepted)
  },
  "rejected": {
    object (Rejected)
  },
  "challenged": {
    object (Challenged)
  },
  "canceled": {
    object (Canceled)
  },
  "revoked": {
    object (Revoked)
  },
  "expired": {
    object (Expired)
  }
  // End of list of possible types for union field status.
}
ক্ষেত্র
ইউনিয়ন ফিল্ড status । আবশ্যক। একটি প্রুফিংয়ের জন্য সম্ভাব্য বিভিন্ন স্ট্যাটাস ধারণকারী একটি বিকল্প। status নিম্নলিখিতগুলির মধ্যে কেবল একটি হতে পারে:
pending

object ( Pending )

অপেক্ষাধীন অবস্থা, যা নির্দেশ করে যে ইস্যুকারী এখনও কোনো সিদ্ধান্ত নেয়নি।

accepted

object ( Accepted )

একটি গৃহীত অবস্থা, যা নির্দেশ করে যে ইস্যুকারী প্রুফিংটি গ্রহণ করেছে।

rejected

object ( Rejected )

প্রত্যাখ্যাত অবস্থা, যা নির্দেশ করে যে ইস্যুকারী প্রুফিংটি প্রত্যাখ্যান করেছে।

challenged

object ( Challenged )

একটি চ্যালেঞ্জড স্ট্যাটাস, যা নির্দেশ করে যে প্রুফিংয়ের বিষয়ে সিদ্ধান্ত নেওয়ার আগে ইস্যুকারী চান ব্যবহারকারী যেন একটি চ্যালেঞ্জ সম্পন্ন করেন।

canceled

object ( Canceled )

বাতিল স্ট্যাটাস, যা নির্দেশ করে যে ব্যবহারকারী প্রুফিংটি বাতিল করেছেন।

revoked

object ( Revoked )

প্রত্যাহারকৃত অবস্থা, যা নির্দেশ করে যে ইস্যুকারী প্রুফিংটি প্রত্যাহার করে নিয়েছে।

expired

object ( Expired )

একটি মেয়াদোত্তীর্ণ অবস্থা, যা নির্দেশ করে যে ইস্যুকারী কর্তৃক নির্ধারিত সময়সীমার আগে প্রুফিংটির বিষয়ে কোনো সিদ্ধান্ত নেওয়া হয়নি (সম্ভবত কোনো আপত্তি সম্পূর্ণ না হওয়ার কারণে)।

বিচারাধীন

এই প্রকারে কোনো ক্ষেত্র নেই।

একটি অপেক্ষমান অবস্থা নির্দেশকারী অবজেক্ট। এই বার্তাটি এই মুহূর্তে ইচ্ছাকৃতভাবে খালি রাখা হয়েছে। ভবিষ্যতে নতুন ফিল্ড যোগ করা হতে পারে।

গৃহীত

এই প্রকারে কোনো ক্ষেত্র নেই।

একটি বস্তু যা গৃহীত প্রুফিং স্থিতি উপস্থাপন করে।

প্রত্যাখ্যাত

একটি বস্তু যা প্রত্যাখ্যাত প্রুফিং স্থিতি উপস্থাপন করে।

JSON উপস্থাপনা 
{
  "primaryRejection": {
    object (Rejection)
  },
  "additionalRejections": [
    {
      object (Rejection)
    }
  ]
}
ক্ষেত্র
primaryRejection

object ( Rejection )

এই প্রুফিংটির প্রত্যাখ্যাত হওয়ার প্রধান কারণ।

additionalRejections[]

object ( Rejection )

প্রুফিংটি কেন প্রত্যাখ্যাত হয়েছে, তার অতিরিক্ত কারণ (যদি থাকে)।

প্রত্যাখ্যান

এমন একটি অবজেক্ট, যাতে একটি নির্দিষ্ট প্রত্যাখ্যানের কারণ সম্পর্কিত বিবরণ থাকে, যার ফলে কোনো প্রুফিং-এর অবস্থা প্রত্যাখ্যাত হয়।

JSON উপস্থাপনা 
{
  "rejectionDescription": string,
  "issuerRejectionIdentifier": string,

  // Union field reason can be only one of the following:
  "evidenceMismatch": {
    object (EvidenceMismatch)
  },
  "evidenceIncomplete": {
    object (EvidenceIncomplete)
  },
  "lowRiskScore": {
    object (LowRiskScore)
  },
  "recordNotFound": {
    object (RecordNotFound)
  },
  "recordInvalid": {
    object (RecordInvalid)
  },
  "maxProvisioningsReached": {
    object (MaxProvisioningsReached)
  },
  "riskCheckFailure": {
    object (RiskCheckFailure)
  },
  "livenessCheckFailure": {
    object (LivenessCheckFailure)
  }
  // End of list of possible types for union field reason.
}
ক্ষেত্র
rejectionDescription

string

সাপোর্ট প্রতিনিধিদের ডিবাগ করার জন্য এই রিজেকশনের একটি বিবরণ। উল্লেখ্য যে, এটি ব্যবহারকারীদের কখনও দেখানো হয় না। এতে ডিবাগিংয়ের জন্য ব্যবহৃত বর্ণনামূলক, অসংবেদনশীল টেক্সট থাকতে পারে।

সতর্কীকরণ: এই বার্তায় কোনো ব্যক্তিগত শনাক্তকরণ তথ্য (PII) অন্তর্ভুক্ত করবেন না।

issuerRejectionIdentifier

string

এই শনাক্তকারীটি ইস্যুকারীর জন্য নির্দিষ্ট এবং এটি ইস্যুকারী দ্বারা তৈরি করা হয়। এটি শুধুমাত্র ডিবাগিংয়ের উদ্দেশ্যে প্রত্যাখ্যানটি শনাক্ত করার জন্য ব্যবহৃত হয়। এই শনাক্তকারীটির মাধ্যমেই ইস্যুকারী এই প্রত্যাখ্যানটি সম্পর্কে জানতে পারে।

ইউনিয়ন ফিল্ডের reason । আবশ্যক। একটি প্রুফিং প্রত্যাখ্যান করার বিভিন্ন কারণের মধ্যে এটি একটি হতে হবে। reason নিম্নলিখিতগুলির মধ্যে কেবল একটি হতে পারে:
evidenceMismatch

object ( EvidenceMismatch )

প্রমাণের অমিলের কারণে প্রুফরিডিংটি প্রত্যাখ্যাত হয়েছে।

ব্যবহারের উদাহরণ: - অ্যাপে তোলা সেলফি এবং ইস্যুকারীর সিস্টেমে থাকা ছবির মধ্যে অমিল। - অ্যাপে তোলা ডকুমেন্টের ছবি এবং ইস্যুকারীর সিস্টেমে থাকা ছবির মধ্যে অমিল।

evidenceIncomplete

object ( EvidenceIncomplete )

এটি নির্দেশ করে যে অসম্পূর্ণ প্রমাণের কারণে প্রুফরিডিংটি প্রত্যাখ্যান করা হয়েছিল।

ব্যবহারের উদাহরণ: - ইস্যুকারী সকল প্রয়োজনীয় প্রমাণপত্র পাননি।

lowRiskScore
(deprecated)

object ( LowRiskScore )

(অপ্রচলিত: প্রয়োজন অনুযায়ী riskCheckFailure বা livenessCheckFailure ব্যবহার করুন)

কম ঝুঁকি স্কোরের কারণে প্রুফরিডিংটি প্রত্যাখ্যাত হয়েছে।

ব্যবহারের উদাহরণ: - প্রদত্ত ওয়ালেটের ঝুঁকি স্কোর কম। - বারবার ব্যর্থ চেষ্টার কারণে ইস্যুকারী এই ব্যবহারকারীকে লক করে দিয়েছে।

recordNotFound

object ( RecordNotFound )

এটি নির্দেশ করে যে, ইস্যুকারীর সিস্টেমে রেকর্ডটি বিদ্যমান না থাকায় প্রুফিংটি প্রত্যাখ্যান করা হয়েছে।

ব্যবহারের উদাহরণ: - ইস্যুকারীর সিস্টেমে রেকর্ডটি খুঁজে পাওয়া যায়নি। - একটি নির্দিষ্ট রেকর্ড অপ্ট-আউট করা হয়েছে।

recordInvalid

object ( RecordInvalid )

এটি নির্দেশ করে যে, ইস্যুকারীর সিস্টেমে থাকা রেকর্ডটি অবৈধ অবস্থায় থাকার কারণে প্রুফিংটি প্রত্যাখ্যান করা হয়েছে।

ব্যবহারের উদাহরণ: - রেকর্ডটি বাতিল অবস্থায় আছে। - রেকর্ডটির মেয়াদ শেষ হয়ে গেছে।

maxProvisioningsReached

object ( MaxProvisioningsReached )

অনুমোদিত সর্বোচ্চ সংখ্যক ডিভাইসে নথিটি সরবরাহ করার কারণে প্রুফিংটি প্রত্যাখ্যান করা হয়েছে।

riskCheckFailure

object ( RiskCheckFailure )

ঝুঁকি স্কোর যাচাইয়ে ব্যর্থতার কারণে প্রুফরিডিংটি প্রত্যাখ্যাত হয়েছে।

ব্যবহারের উদাহরণ: - প্রদত্ত ওয়ালেটের ঝুঁকি স্কোর বেশি, যা প্রতারণার উচ্চ ঝুঁকি নির্দেশ করে। - ইস্যুকারী অনুরোধটিকে প্রতারণার উচ্চ ঝুঁকি হিসেবে মূল্যায়ন করছে।

livenessCheckFailure

object ( LivenessCheckFailure )

লাইভনেস চেক ব্যর্থতার কারণে প্রুফরিডিংটি প্রত্যাখ্যাত হয়েছে।

ব্যবহারের উদাহরণ: - ওয়ালেটটির লাইভনেস স্কোর কম।

প্রমাণের অমিল

প্রমাণের অমিলজনিত প্রত্যাখ্যান নির্দেশকারী একটি বস্তু।

JSON উপস্থাপনা 
{
  "evidenceType": string
}
ক্ষেত্র
evidenceType

string

যে প্রমাণগুলো মেলানো যায়নি তার বিবরণ। শুধুমাত্র ডিবাগিংয়ের উদ্দেশ্যে ব্যবহৃত।

প্রমাণ অসম্পূর্ণ

একটি বস্তু যা প্রমাণের অসম্পূর্ণ প্রত্যাখ্যান নির্দেশ করে।

JSON উপস্থাপনা 
{
  "evidenceType": string
}
ক্ষেত্র
evidenceType

string

প্রমাণের একটি অসম্পূর্ণ বিবরণ। শুধুমাত্র ডিবাগিংয়ের উদ্দেশ্যে ব্যবহৃত।

LowRiskScore

এই প্রকারে কোনো ক্ষেত্র নেই।

কম ঝুঁকির কারণে প্রত্যাখ্যান নির্দেশকারী একটি অবজেক্ট। এই বার্তাটি আপাতত ইচ্ছাকৃতভাবে খালি রাখা হয়েছে। ভবিষ্যতে নতুন ফিল্ড যোগ করা হতে পারে।

রেকর্ড পাওয়া যায়নি

এই প্রকারে কোনো ক্ষেত্র নেই।

রেকর্ড খুঁজে না পাওয়ার কারণে প্রত্যাখ্যান নির্দেশকারী একটি অবজেক্ট। এই বার্তাটি আপাতত ইচ্ছাকৃতভাবে খালি রাখা হয়েছে। ভবিষ্যতে নতুন ফিল্ড যোগ করা হতে পারে।

রেকর্ড অবৈধ

একটি বস্তু যা একটি অবৈধ রেকর্ড প্রত্যাখ্যান নির্দেশ করে।

JSON উপস্থাপনা 
{
  "invalidityReason": string
}
ক্ষেত্র
invalidityReason

string

রেকর্ডটি কেন অবৈধ তার বিবরণ।

সর্বোচ্চ সরবরাহ পৌঁছেছে

সর্বোচ্চ সরবরাহ পূর্ণ হওয়ার ইঙ্গিতকারী একটি অবজেক্ট প্রত্যাখ্যান করা হয়েছে।

JSON উপস্থাপনা 
{
  "maxNumberOfProvisioningsAllowed": integer
}
ক্ষেত্র
maxNumberOfProvisioningsAllowed

integer

ইস্যুকারীর নীতি অনুযায়ী অনুমোদিত সর্বোচ্চ প্রভিশনিং সংখ্যা।

ঝুঁকি যাচাই ব্যর্থতা

এই প্রকারে কোনো ক্ষেত্র নেই।

ঝুঁকি যাচাইয়ে ব্যর্থতার কারণে প্রত্যাখ্যান নির্দেশকারী একটি অবজেক্ট। এই বার্তাটি আপাতত ইচ্ছাকৃতভাবে খালি রাখা হয়েছে। ভবিষ্যতে নতুন ফিল্ড যোগ করা হতে পারে।

লাইভনেসচেকফেলিউর

এই প্রকারে কোনো ক্ষেত্র নেই।

লাইভনেস চেক ব্যর্থতা প্রত্যাখ্যান নির্দেশকারী একটি অবজেক্ট। এই বার্তাটি আপাতত ইচ্ছাকৃতভাবে খালি রাখা হয়েছে। ভবিষ্যতে নতুন ফিল্ড যোগ করা হতে পারে।

চ্যালেঞ্জ করা হয়েছে

একটি বস্তু যা একটি চ্যালেঞ্জকৃত প্রুফিং স্থিতি উপস্থাপন করে।

JSON উপস্থাপনা 
{
  "challengeDescription": string,

  // Union field challenge can be only one of the following:
  "physicalLocationVisit": {
    object (PhysicalLocationVisit)
  },
  "issuerUrlVisit": {
    object (IssuerUrlVisit)
  },
  "additionalTimeRequired": {
    object (AdditionalTimeRequired)
  }
  // End of list of possible types for union field challenge.
}
ক্ষেত্র
challengeDescription

string

আবশ্যক। সাপোর্ট প্রতিনিধিদের ডিবাগ করার জন্য সমস্যাটির একটি বিবরণ। উল্লেখ্য যে, এটি ব্যবহারকারীদের কখনও দেখানো হয় না। এতে ডিবাগিংয়ের জন্য ব্যবহৃত বর্ণনামূলক, অসংবেদনশীল লেখা থাকতে পারে।

সতর্কীকরণ: এই বার্তায় কোনো ব্যক্তিগত শনাক্তকরণ তথ্য (PII) অন্তর্ভুক্ত করবেন না।

ইউনিয়ন ফিল্ড challenge । আবশ্যক। ব্যবহারকারীকে যে বিভিন্ন চ্যালেঞ্জগুলো সম্পন্ন করতে হতে পারে, তার মধ্যে থেকে একটি। challenge নিম্নলিখিতগুলোর মধ্যে কেবল একটি হতে পারে:
physicalLocationVisit

object ( PhysicalLocationVisit )

এমন একটি চ্যালেঞ্জ যেখানে একজন ব্যবহারকারীকে সেটি সম্পন্ন করার জন্য কোনো একটি নির্দিষ্ট স্থানে, যেমন ইস্যুকারী প্রতিষ্ঠানের অফিসে, উপস্থিত হতে হয়।

issuerUrlVisit

object ( IssuerUrlVisit )

একটি চ্যালেঞ্জ বিকল্প যেখানে ব্যবহারকারীকে প্রদানকারীর দেওয়া একটি ইউআরএল-এ গিয়ে একটি চ্যালেঞ্জ সম্পন্ন করতে হয়।

additionalTimeRequired

object ( AdditionalTimeRequired )

একটি চ্যালেঞ্জ বিকল্প, যেখানে এই প্রুফরিডিংটি পর্যালোচনা করার জন্য আরও কিছুটা সময় প্রয়োজন।

শারীরিক অবস্থান পরিদর্শন

এই প্রকারে কোনো ক্ষেত্র নেই।

এটি এমন একটি অবজেক্ট যা চ্যালেঞ্জ অপশনকে উপস্থাপন করে, যেখানে একজন ব্যবহারকারীকে একটি চ্যালেঞ্জ সম্পূর্ণ করার জন্য কোনো একটি নির্দিষ্ট স্থানে, যেমন ইস্যুকারীর অফিসে, যেতে হয়। এই চ্যালেঞ্জটি গুগলের আওতার বাইরে। নিরাপত্তার কারণে, যদি ইস্যুকারী এই ধরনের চ্যালেঞ্জ সমর্থন করে, তবে অনবোর্ডিংয়ের সময় তাদের অবশ্যই গুগলকে অবস্থানের বিবরণ প্রদান করতে হবে।

IssuerUrlVisit

এই প্রকারে কোনো ক্ষেত্র নেই।

এটি এমন একটি অবজেক্ট যা চ্যালেঞ্জ অপশনকে উপস্থাপন করে, যেখানে একজন ব্যবহারকারীকে ইস্যুকারী কর্তৃক প্রদত্ত একটি ইউআরএল-এ গিয়ে একটি চ্যালেঞ্জ সম্পন্ন করতে হয়। এই চ্যালেঞ্জটি গুগলের আওতার বাইরে। নিরাপত্তার কারণে, যদি ইস্যুকারী এই ধরনের চ্যালেঞ্জ সমর্থন করে, তবে অনবোর্ডিংয়ের সময় তাদের অবশ্যই গুগলকে ইউআরএলটি সরবরাহ করতে হবে।

অতিরিক্ত সময় প্রয়োজন

চ্যালেঞ্জ বিকল্পের একটি অবজেক্ট, যেখানে প্রুফিং পর্যালোচনার জন্য অতিরিক্ত সময়ের প্রয়োজন হয়। আনুমানিক সমাপ্তির সময় ঐচ্ছিকভাবে প্রদান করা যেতে পারে।

JSON উপস্থাপনা 
{
  "estimatedCompletion": string
}
ক্ষেত্র
estimatedCompletion

string ( int64 format)

যে আনুমানিক সময়ে প্রুফরিডিং সম্পন্ন হবে। পর্যালোচনা, যদি উপলব্ধ থাকে। ফরম্যাটটি হলো একটি টাইমস্ট্যাম্প এবং টাইমস্ট্যাম্পটি ইউনিক্স ইপক থেকে মিলিসেকেন্ডের সংখ্যা হিসাবে প্রকাশ করা হয়।

বাতিল করা হয়েছে

এই প্রকারে কোনো ক্ষেত্র নেই।

বাতিলকৃত প্রুফিং স্ট্যাটাস নির্দেশকারী একটি অবজেক্ট। এই বার্তাটি আপাতত ইচ্ছাকৃতভাবে খালি রাখা হয়েছে। ভবিষ্যতে নতুন ফিল্ড যোগ করা হতে পারে।

বাতিল করা হয়েছে

এই প্রকারে কোনো ক্ষেত্র নেই।

একটি প্রত্যাহারকৃত প্রুফিং স্ট্যাটাস নির্দেশকারী অবজেক্ট। এই বার্তাটি এই মুহূর্তে ইচ্ছাকৃতভাবে খালি রাখা হয়েছে। ভবিষ্যতে নতুন ফিল্ড যোগ করা হতে পারে।

মেয়াদোত্তীর্ণ

এই প্রকারে কোনো ক্ষেত্র নেই।

মেয়াদোত্তীর্ণ প্রুফিং স্ট্যাটাস নির্দেশকারী একটি অবজেক্ট। এই বার্তাটি এই মুহূর্তে ইচ্ছাকৃতভাবে খালি রাখা হয়েছে। ভবিষ্যতে নতুন ফিল্ড যোগ করা হতে পারে।