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)

الحقل مطلوب. البيانات الوصفية للاستجابة، وهي مطلوبة في جميع الاستجابات