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 รายการแยกกันในอุปกรณ์เครื่องเดียวกัน รหัสนี้จะแตกต่างกันระหว่างข้อมูลเข้าสู่ระบบทั้ง 2 รายการ

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

string

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

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

string

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

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

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

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

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

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

object (ResponseMetadata)

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