Method: vdc.proofUser

यह एक ऐसा एंडपॉइंट है जो किसी उपयोगकर्ता की डिजिटल क्रेडेंशियल के लिए पुष्टि करता है. इसके लिए, यह जारी करने वाले व्यक्ति या कंपनी की ओर से उपलब्ध कराए गए सबूतों की सूची और किसी खास डिवाइस का इस्तेमाल करता है.

एचटीटीपी अनुरोध

POST https://example.issuer.com/api/v1/vdc/proofUser

अनुरोध का मुख्य भाग

अनुरोध के मुख्य हिस्से में, इस स्ट्रक्चर का डेटा शामिल होता है:

JSON के काेड में दिखाना 
{
  "requestMetadata": {
    object (RequestMetadata)
  },
  "deviceReferenceId": string,
  "proofingId": string,
  "evidence": [
    {
      object (ProofingEvidence)
    }
  ],

  // Union field proofing_context can be only one of the following:
  "reverificationContext": {
    object (ReverificationContext)
  }
  // End of list of possible types for union field proofing_context.
}
फ़ील्ड
requestMetadata

object (RequestMetadata)

अनुरोध के बारे में मेटाडेटा. यह सभी अनुरोधों में ज़रूरी होता है.
deviceReferenceId

string

यह आईडी, डिवाइस और उससे जुड़ी आइडेंटिटी कुंजी से मेल खाता है. यह डिवाइस आईडी नहीं है. इसका मतलब है कि अगर उपयोगकर्ता के पास एक ही डिवाइस पर दो अलग-अलग क्रेडेंशियल हैं, तो यह आईडी दोनों के लिए अलग-अलग होगा.

यह आईडी सभी अनुरोधों में दिया जाता है. इसका इस्तेमाल अनुरोधों को आपस में जोड़ने के लिए किया जा सकता है.
proofingId

string

यह एक ओपेक आइडेंटिफ़ायर है. यह किसी डिवाइस के लिए, सबूतों के किसी बंडल के साथ पुष्टि करने की प्रोसेस को दिखाता है.

उदाहरण: यूयूआईडी
evidence[]

object (ProofingEvidence)

डिजिटल क्रेडेंशियल के लिए, किसी उपयोगकर्ता की पहचान की पुष्टि करने के लिए ज़रूरी सबूतों की सूची.
यूनियन फ़ील्ड proofing_context. प्रूफिंग का कॉन्टेक्स्ट. शुरुआती जांच के लिए खाली छोड़ें. proofing_context इनमें से सिर्फ़ एक हो सकता है:
reverificationContext

object (ReverificationContext)

फिर से पुष्टि करने के सबूत का कॉन्टेक्स्ट.

जवाब का मुख्य भाग

डिजिटल क्रेडेंशियल के लिए किसी उपयोगकर्ता की पुष्टि करने के अनुरोध को स्वीकार करने की सूचना. इससे पता चलता है कि पुष्टि करने की प्रोसेस अब शुरू हो गई है.

अगर एपीआई सही से जुड़ जाता है, ताे जवाब के मुख्य भाग में नीचे दिए गए स्ट्रक्चर शामिल होता है.

JSON फ़ॉर्मैट में दिखाया गया है 
{
  "responseMetadata": {
    object (ResponseMetadata)
  },
  "proofingId": string
}
फ़ील्ड
responseMetadata

object (ResponseMetadata)

जवाब के बारे में मेटाडेटा. यह सभी जवाबों में ज़रूरी होता है.
proofingId

string

यह एक ओपेक आइडेंटिफ़ायर है. यह किसी डिवाइस के लिए, सबूतों के किसी बंडल के साथ पुष्टि करने की प्रोसेस को दिखाता है. यह वही आईडी है जिसे अनुरोध में भेजा गया था.

ProofingEvidence

यह एक ऐसा ऑब्जेक्ट होता है जो सबूत के एक हिस्से को दिखाता है.

JSON के काेड में दिखाना 
{

  // Union field evidence_type can be only one of the following:
  "preAuthorizationCode": {
    object (Evidence)
  }
  // End of list of possible types for union field evidence_type.
}
फ़ील्ड
यूनियन फ़ील्ड evidence_type. यह एक ऐसा विकल्प है जिससे पता चलता है कि सबूत कैसे पेश किया जा रहा है. evidence_type इनमें से सिर्फ़ एक हो सकता है:
preAuthorizationCode

object (Evidence)

कार्ड जारी करने वाले बैंक से भेजा गया प्री-ऑथराइज़ेशन कोड.

एविडेंस

यह एक ऐसा ऑब्जेक्ट होता है जो सबूत के एक हिस्से को दिखाता है.

JSON के काेड में दिखाना 
{

  // Union field presencetype can be only one of the following:
  "encryptedData": {
    object (EncryptedData)
  },
  "unencryptedValue": string,
  "unencryptedInteger": integer
  // End of list of possible types for union field presencetype.
}
फ़ील्ड
यूनियन फ़ील्ड presencetype. यह एक ऐसा विकल्प है जिससे पता चलता है कि सबूत कैसे पेश किया जा रहा है. presencetype इनमें से सिर्फ़ एक हो सकता है:
encryptedData

object (EncryptedData)

एन्क्रिप्ट की गई वैल्यू और वैल्यू को डिक्रिप्ट करने के लिए ज़रूरी एन्क्रिप्शन मेटाडेटा.
unencryptedValue

string

सबूत की base64 कोड में बदली गई वैल्यू.
unencryptedInteger

integer

सबूत की पूर्णांक वैल्यू.

ReverificationContext

क्रेडेंशियल की फिर से पुष्टि करने के लिए ज़रूरी कॉन्टेक्स्ट.

JSON के काेड में दिखाना 
{
  "credentialId": string
}
फ़ील्ड
credentialId

string

वह क्रेडेंशियल आईडी जिस पर फिर से पुष्टि की जाती है.