Method: vdc.provisionCredential

ক্রেডেনশিয়াল সরবরাহ করার একটি এন্ডপয়েন্ট।

HTTP অনুরোধ

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

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

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

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

object ( RequestMetadata )

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

deviceReferenceId

string

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

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

credentialId

string

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

যদি credentialId-টি আগে থেকেই বিদ্যমান থাকে, তাহলে নতুন ক্রেডেনশিয়াল তৈরি করার পরিবর্তে এই মেথডটির উচিত বিদ্যমান ক্রেডেনশিয়ালটি রিটার্ন করা।

উদাহরণ: UUID

proofingId

string

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

প্রুফিং অবশ্যই অনুমোদিত অবস্থায় থাকতে হবে। অন্যথায়, একটি অবৈধ শনাক্তকারী ErrorResponse ফেরত দেওয়া উচিত।

deviceEncryptionKey

object ( DeviceEncryptionKey )

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

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

প্রদত্ত পরিচয়পত্র সম্বলিত একটি প্রতিক্রিয়া।

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

JSON উপস্থাপনা 
{
  "responseMetadata": {
    object (ResponseMetadata)
  },
  "credential": {
    object (Credential)
  },
  "credentialVersionId": string
}
ক্ষেত্র
responseMetadata

object ( ResponseMetadata )

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

credential

object ( Credential )

প্রয়োজনীয়। প্রদত্ত পরিচয়পত্র।

credentialVersionId

string

আবশ্যক। প্রদত্ত ক্রেডেনশিয়ালের বর্তমান সংস্করণ।

শংসাপত্র

ক্রেডেনশিয়াল টাইপের জন্য প্রাসঙ্গিক ISO স্ট্যান্ডার্ড দ্বারা সংজ্ঞায়িত mdoc ভিত্তিক ক্রেডেনশিয়াল।

উদাহরণস্বরূপ, একটি মোবাইল ড্রাইভিং লাইসেন্সের জন্য, এটি হবে ISO/IEC 18013-5। mDL mDoc ফরম্যাটের জন্য এটি দেখুন।

JSON উপস্থাপনা 
{

  // Union field presencetype can be only one of the following:
  "encryptedData": {
    object (EncryptedData)
  },
  "unencryptedValue": string
  // End of list of possible types for union field presencetype.
}
ক্ষেত্র
ইউনিয়ন ফিল্ড presencetype । আবশ্যক। এটি এমন একটি বিকল্প যা নির্দেশ করে ক্রেডেনশিয়ালটি কীভাবে উপস্থাপন করা হচ্ছে। presencetype নিম্নলিখিতগুলির মধ্যে কেবল একটি হতে পারে:
encryptedData

object ( EncryptedData )

এনক্রিপ্ট করা মান এবং মানটি ডিক্রিপ্ট করার জন্য প্রয়োজনীয় এনক্রিপশন মেটাডেটা।

unencryptedValue

string

ক্রেডেনশিয়ালটির বেস৬৪ এনকোডেড মান।