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 )

فراداده مربوط به پاسخ، که در همه پاسخ‌ها الزامی است.