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টি ইতিমধ্যেই বিদ্যমান থাকে, তাহলে নতুন credential তৈরি করার পরিবর্তে, এই পদ্ধতিটি বিদ্যমান credentialটি ফিরিয়ে দেবে।

যেমন: UUID

proofingId

string

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

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

deviceEncryptionKey

object ( DeviceEncryptionKey )

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

প্রতিক্রিয়া মূল অংশ

প্রভিশন করা শংসাপত্র সম্বলিত একটি প্রতিক্রিয়া।

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

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

object ( ResponseMetadata )

সমস্ত প্রতিক্রিয়ার জন্য প্রয়োজনীয় প্রতিক্রিয়া সম্পর্কে মেটাডেটা।

credential

object ( Credential )

প্রভিশন করা শংসাপত্র।

credentialVersionId

string

প্রবিধান করা শংসাপত্রের বর্তমান সংস্করণ।

পরিচয়পত্র

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

উদাহরণস্বরূপ, একটি মোবাইল ড্রাইভিং লাইসেন্সের জন্য, এটি 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

শংসাপত্রের বেস৬৪ এনকোডেড মান।