Method: vdc.registerDevice

نقطة نهاية لتسجيل جهاز لدى جهة الإصدار

طلب HTTP

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

نص الطلب

يتضمن نص الطلب بيانات بالبنية التالية:

تمثيل JSON 
{
  "requestMetadata": {
    object (RequestMetadata)
  },
  "deviceReferenceId": string,
  "deviceIdentityCertificate": string,
  "deviceIdentityCertificateChain": [
    string
  ]
}
الحقول
requestMetadata

object (RequestMetadata)

البيانات الوصفية المتعلّقة بالطلب، وهي مطلوبة في جميع الطلبات
deviceReferenceId

string

المعرّف الذي يتوافق مع الجهاز ومفتاح الهوية المرتبط بالجهاز هذا ليس معرّف جهاز، ما يعني أنّه إذا كان لدى المستخدم بيانات اعتماد منفصلة على الجهاز نفسه، سيختلف هذا المعرّف بينهما.

يتم تقديم رقم التعريف هذا في جميع الطلبات، ويمكن استخدامه لربط الطلبات.
deviceIdentityCertificate

string

(تم إيقاف هذا الحقل نهائيًا: استخدِم deviceIdentityCertificateChain) سلسلة شهادات X.509، وهي فريدة لجهاز وبيانات اعتماد محدّدة.

تحتوي هذه الشهادة على مفتاح هوية الجهاز وشهادة إثبات صحة الجهاز والقيمة العشوائية الموقَّعة.
deviceIdentityCertificateChain[]

string

قائمة بشهادات X.509 في سلسلة الشهادات، وهي فريدة لجهاز وبيانات اعتماد محدّدة.

تحتوي سلسلة الشهادات هذه على مفتاح هوية الجهاز وشهادة مصادقة الجهاز والقيمة العشوائية الموقَّعة.

نص الاستجابة

ردّ يؤكّد تسجيل الجهاز

إذا كانت الاستجابة ناجحة، سيحتوي نص الاستجابة على بيانات بالبنية التالية:

تمثيل JSON 
{
  "responseMetadata": {
    object (ResponseMetadata)
  }
}
الحقول
responseMetadata

object (ResponseMetadata)

البيانات الوصفية الخاصة بالرد، وهي مطلوبة في جميع الردود.