किसी डिवाइस को जारी करने वाले संगठन के साथ रजिस्टर करने के लिए, एक एंडपॉइंट.
एचटीटीपी अनुरोध
POST https://example.issuer.com/api/v1/vdc/registerDevice
अनुरोध का मुख्य हिस्सा
अनुरोध के मुख्य हिस्से में, इस स्ट्रक्चर का डेटा शामिल होता है:
| JSON के काेड में दिखाना |
|---|
{
"requestMetadata": {
object ( |
| फ़ील्ड | |
|---|---|
requestMetadata |
ज़रूरी है. अनुरोध के बारे में मेटाडेटा. यह सभी अनुरोधों के लिए ज़रूरी है. |
deviceReferenceId |
ज़रूरी है. यह आईडी, डिवाइस और उससे जुड़ी आइडेंटिटी की से जुड़ा होता है. यह डिवाइस आईडी नहीं है. इसका मतलब है कि अगर किसी उपयोगकर्ता के पास एक ही डिवाइस पर दो अलग-अलग क्रेडेंशियल हैं, तो यह आईडी दोनों के लिए अलग-अलग होगा. यह आईडी सभी अनुरोधों में दिया जाता है. इसका इस्तेमाल, अनुरोधों को कोरिलेट करने के लिए किया जा सकता है. |
deviceIdentityCertificate |
(अब इसका इस्तेमाल नहीं किया जाता: इसके बजाय, deviceIdentityCertificateChain का इस्तेमाल करें ) यह X.509 प्रमाणपत्र चेन है. यह किसी खास डिवाइस और क्रेडेंशियल के लिए यूनीक होती है. इस प्रमाणपत्र में डिवाइस की आइडेंटिटी की, डिवाइस एटेस्टेशन, और साइन किया गया नॉनस शामिल होता है. |
deviceIdentityCertificateChain[] |
ज़रूरी है. यह प्रमाणपत्र चेन में शामिल X.509 प्रमाणपत्रों की सूची है. यह किसी खास डिवाइस और क्रेडेंशियल के लिए यूनीक होती है. इस प्रमाणपत्र चेन में डिवाइस की आइडेंटिटी की, डिवाइस एटेस्टेशन, और साइन किया गया नॉनस शामिल होता है. |
जवाब का मुख्य हिस्सा
डिवाइस रजिस्टर होने की पुष्टि करने वाला जवाब.
अगर एपीआई सही से जुड़ जाता है, ताे जवाब के मुख्य भाग में नीचे दिए गए स्ट्रक्चर शामिल होता है:
| JSON फ़ॉर्मैट में दिखाया गया है |
|---|
{
"responseMetadata": {
object ( |
| फ़ील्ड | |
|---|---|
responseMetadata |
ज़रूरी है. जवाब के बारे में मेटाडेटा. यह सभी जवाबों के लिए ज़रूरी है. |