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

รหัสที่สอดคล้องกับอุปกรณ์และคีย์ข้อมูลประจำตัวที่เชื่อมโยงกับอุปกรณ์ นี่ไม่ใช่รหัสอุปกรณ์ ซึ่งหมายความว่าหากผู้ใช้มีข้อมูลเข้าสู่ระบบ 2 ชุดแยกกันในอุปกรณ์เดียวกัน รหัสนี้จะแตกต่างกัน

รหัสนี้จะระบุในคำขอทั้งหมด และใช้เพื่อเชื่อมโยงคำขอได้
deviceIdentityCertificate

string

(เลิกใช้งานแล้ว: ใช้ deviceIdentityCertificateChain) เชนใบรับรอง X.509 ที่ไม่ซ้ำกันสำหรับอุปกรณ์และข้อมูลเข้าสู่ระบบที่เฉพาะเจาะจง

ใบรับรองนี้มีคีย์ข้อมูลระบุตัวตนของอุปกรณ์ การรับรองอุปกรณ์ และหมายเลขสุ่มที่ลงชื่อ
deviceIdentityCertificateChain[]

string

รายการใบรับรอง X.509 ในเชนใบรับรองซึ่งไม่ซ้ำกันสำหรับอุปกรณ์และข้อมูลเข้าสู่ระบบที่เฉพาะเจาะจง

ห่วงโซ่ใบรับรองนี้มีคีย์ข้อมูลระบุตัวตนของอุปกรณ์ การรับรองอุปกรณ์ และ Nonce ที่ลงชื่อ

เนื้อหาการตอบกลับ

การตอบกลับที่รับทราบการลงทะเบียนอุปกรณ์

หากทำสำเร็จ เนื้อหาการตอบกลับจะมีข้อมูลซึ่งมีโครงสร้างดังต่อไปนี้

การแสดง JSON 
{
  "responseMetadata": {
    object (ResponseMetadata)
  }
}
ช่อง
responseMetadata

object (ResponseMetadata)

ข้อมูลเมตาเกี่ยวกับคำตอบ ซึ่งจำเป็นต้องมีในคำตอบทั้งหมด