Method: vdc.getProofingStatus

यह एंडपॉइंट, स्पेलिंग और व्याकरण की जांच की मौजूदा स्थिति को वापस पाने के लिए होता है.

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

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

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

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

JSON के काेड में दिखाना 
{
  "requestMetadata": {
    object (RequestMetadata)
  },
  "deviceReferenceId": string,
  "proofingId": string
}
फ़ील्ड
requestMetadata

object (RequestMetadata)

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

string

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

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

string

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

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

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

जवाब में, प्रूफिंग की मौजूदा स्थिति के बारे में जानकारी होती है.

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

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

object (ResponseMetadata)

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

object (ProofingStatus)

ज़रूरी है. प्रूफिंग की मौजूदा स्थिति.

ProofingStatus

यह ऑब्जेक्ट, अलग-अलग स्टेटस दिखाता है.

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

  // Union field status can be only one of the following:
  "pending": {
    object (Pending)
  },
  "accepted": {
    object (Accepted)
  },
  "rejected": {
    object (Rejected)
  },
  "challenged": {
    object (Challenged)
  },
  "canceled": {
    object (Canceled)
  },
  "revoked": {
    object (Revoked)
  },
  "expired": {
    object (Expired)
  }
  // End of list of possible types for union field status.
}
फ़ील्ड
यूनियन फ़ील्ड status. ज़रूरी है. यह एक ऐसा ऑब्जेक्ट है जिसमें पुष्टि करने की प्रोसेस के अलग-अलग स्टेटस शामिल होते हैं. status इनमें से सिर्फ़ एक हो सकता है:
pending

object (Pending)

'कार्रवाई ज़रूरी है' स्टेटस, यह दिखाता है कि कार्ड जारी करने वाली कंपनी ने अब तक कोई फ़ैसला नहीं लिया है.
accepted

object (Accepted)

स्वीकार किया गया स्टेटस. इससे पता चलता है कि जारी करने वाले ने पुष्टि स्वीकार कर ली है.
rejected

object (Rejected)

'अस्वीकार कर दिया गया' स्थिति. इससे पता चलता है कि जारी करने वाली कंपनी ने पुष्टि करने की प्रोसेस को अस्वीकार कर दिया है.
challenged

object (Challenged)

चैलेंज किया गया स्टेटस. इससे पता चलता है कि जारी करने वाला व्यक्ति चाहता है कि उपयोगकर्ता, पहचान की पुष्टि करने से पहले कोई चैलेंज पूरा करे.
canceled

object (Canceled)

रद्द किया गया स्टेटस. इससे पता चलता है कि उपयोगकर्ता ने प्रूफिंग की सुविधा रद्द कर दी है.
revoked

object (Revoked)

'रद्द किया गया' स्टेटस, यह दिखाता है कि जारी करने वाले ने पुष्टि करने की प्रोसेस को रद्द कर दिया है.
expired

object (Expired)

यह स्थिति तब दिखती है, जब पुष्टि करने वाले व्यक्ति ने तय समयसीमा के अंदर पुष्टि नहीं की हो. ऐसा इसलिए हो सकता है, क्योंकि वह चुनौती को पूरा नहीं कर पाया. यह समयसीमा, कार्ड जारी करने वाली कंपनी तय करती है.

मंज़ूरी बाकी है

इस टाइप में कोई फ़ील्ड नहीं है.

यह ऑब्जेक्ट, 'समीक्षा में है' स्थिति को दिखाता है. यह मैसेज जान-बूझकर अभी खाली रखा गया है. आने वाले समय में, नए फ़ील्ड जोड़े जा सकते हैं.

स्वीकार किया गया

इस टाइप में कोई फ़ील्ड नहीं है.

यह एक ऑब्जेक्ट है, जो पुष्टि किए जाने की स्थिति को दिखाता है.

नामंजूर

यह एक ऐसा ऑब्जेक्ट है जो अस्वीकार की गई प्रूफिंग की स्थिति को दिखाता है.

JSON के काेड में दिखाना 
{
  "primaryRejection": {
    object (Rejection)
  },
  "additionalRejections": [
    {
      object (Rejection)
    }
  ]
}
फ़ील्ड
primaryRejection

object (Rejection)

इस सबूत को अस्वीकार किए जाने की मुख्य वजह.
additionalRejections[]

object (Rejection)

अगर कोई और वजह है, तो उसकी जानकारी दें कि पुष्टि करने की प्रक्रिया को अस्वीकार क्यों किया गया है.

आवेदन अस्वीकार होना

यह एक ऐसा ऑब्जेक्ट होता है जिसमें किसी दावे को अस्वीकार किए जाने की वजह के बारे में जानकारी होती है. इस वजह से, दावे की पुष्टि करने की स्थिति को 'अस्वीकार किया गया' के तौर पर सेट किया जाता है.

JSON के काेड में दिखाना 
{
  "rejectionDescription": string,
  "issuerRejectionIdentifier": string,

  // Union field reason can be only one of the following:
  "evidenceMismatch": {
    object (EvidenceMismatch)
  },
  "evidenceIncomplete": {
    object (EvidenceIncomplete)
  },
  "lowRiskScore": {
    object (LowRiskScore)
  },
  "recordNotFound": {
    object (RecordNotFound)
  },
  "recordInvalid": {
    object (RecordInvalid)
  },
  "maxProvisioningsReached": {
    object (MaxProvisioningsReached)
  },
  "riskCheckFailure": {
    object (RiskCheckFailure)
  },
  "livenessCheckFailure": {
    object (LivenessCheckFailure)
  }
  // End of list of possible types for union field reason.
}
फ़ील्ड
rejectionDescription

string

सहायता टीम के सदस्यों के लिए, अस्वीकार किए जाने की वजह का ब्यौरा, ताकि वे समस्या को ठीक कर सकें. ध्यान दें कि यह जानकारी लोगों को कभी नहीं दिखाई जाती. इसमें ब्यौरे वाला ऐसा टेक्स्ट शामिल हो सकता है जिसमें संवेदनशील जानकारी न हो. इसका इस्तेमाल डीबग करने के लिए किया जाता है.

चेतावनी: इस मैसेज में, व्यक्तिगत पहचान से जुड़ी कोई जानकारी शामिल न करें.
issuerRejectionIdentifier

string

यह आइडेंटिफ़ायर, पास जारी करने वाले के लिए खास होता है और इसे पास जारी करने वाला जनरेट करता है. इसका इस्तेमाल सिर्फ़ डीबग करने के लिए किया जाता है, ताकि अस्वीकार किए जाने की वजह का पता लगाया जा सके. यह वह आइडेंटिफ़ायर है जिससे कार्ड जारी करने वाली कंपनी को इस अस्वीकार किए गए लेन-देन के बारे में पता चलता है.
यूनियन फ़ील्ड reason. ज़रूरी है. यह एक oneof है. इसमें वर्तनी और व्याकरण की जांच करने की सुविधा से जुड़े अनुरोध के अस्वीकार होने की अलग-अलग वजहें शामिल होती हैं. reason इनमें से सिर्फ़ एक हो सकता है:
evidenceMismatch

object (EvidenceMismatch)

इससे पता चलता है कि सबूत के मेल न खाने की वजह से, पुष्टि करने की प्रोसेस को अस्वीकार कर दिया गया है.

इस्तेमाल के उदाहरण: - ऐप्लिकेशन में कैप्चर की गई सेल्फ़ी और जारी करने वाले के सिस्टम में मौजूद इमेज का मेल न खाना. - ऐप्लिकेशन कैप्चर करने वाले दस्तावेज़ की इमेज और जारी करने वाले के सिस्टम में मौजूद इमेज का मेल न खाना.
evidenceIncomplete

object (EvidenceIncomplete)

इससे पता चलता है कि सबूत पूरा न होने की वजह से, पुष्टि करने की प्रक्रिया को अस्वीकार कर दिया गया है.

इस्तेमाल के उदाहरण: - जारी करने वाली कंपनी को सभी ज़रूरी सबूत नहीं मिले.
lowRiskScore
(deprecated)

object (LowRiskScore)

(DEPRECATED: use riskCheckFailure or livenessCheckFailure accordingly)

इससे पता चलता है कि जोखिम का स्कोर कम होने की वजह से, पुष्टि करने की प्रोसेस को अस्वीकार कर दिया गया है.

इस्तेमाल के उदाहरण: - वॉलेट से मिले जोखिम का स्कोर कम है. - बार-बार लॉगिन करने की कोशिशें पूरी न होने की वजह से, जारी करने वाली कंपनी ने इस उपयोगकर्ता के खाते को लॉक कर दिया है.
recordNotFound

object (RecordNotFound)

इससे पता चलता है कि पुष्टि करने वाले व्यक्ति के सिस्टम में रिकॉर्ड मौजूद न होने की वजह से, पुष्टि करने की प्रोसेस को अस्वीकार कर दिया गया है.

इस्तेमाल के उदाहरण: - रिकॉर्ड, जारी करने वाले के सिस्टम में नहीं मिला. - किसी रिकॉर्ड के लिए ऑप्ट-आउट किया गया हो.
recordInvalid

object (RecordInvalid)

इससे पता चलता है कि जारी करने वाले के सिस्टम में मौजूद रिकॉर्ड अमान्य होने की वजह से, पुष्टि करने की प्रोसेस को अस्वीकार कर दिया गया है.

इस्तेमाल के उदाहरण: - रिकॉर्ड रद्द कर दिया गया है. - रिकॉर्ड की समयसीमा खत्म हो गई है.
maxProvisioningsReached

object (MaxProvisioningsReached)

इससे पता चलता है कि दस्तावेज़ को तय सीमा से ज़्यादा डिवाइसों पर उपलब्ध कराने की वजह से, उसकी पुष्टि करने का अनुरोध अस्वीकार कर दिया गया है.
riskCheckFailure

object (RiskCheckFailure)

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

इस्तेमाल के उदाहरण: - वॉलेट से मिले जोखिम के स्कोर से पता चलता है कि धोखाधड़ी का जोखिम ज़्यादा है. - कार्ड जारी करने वाली कंपनी को लगता है कि इस अनुरोध में धोखाधड़ी का जोखिम ज़्यादा है.
livenessCheckFailure

object (LivenessCheckFailure)

इससे पता चलता है कि लाइवनेस की जांच पूरी न होने की वजह से, पुष्टि करने की प्रोसेस को अस्वीकार कर दिया गया है.

इस्तेमाल के उदाहरण: - वॉलेट में मौजूद लाइवनेस स्कोर कम है.

EvidenceMismatch

यह ऑब्जेक्ट, सबूत के मेल न खाने की वजह से अस्वीकार किए जाने की जानकारी देता है.

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

string

उस सबूत के बारे में जानकारी जो मेल नहीं खाती. इसका इस्तेमाल सिर्फ़ डीबग करने के लिए किया जाता है.

EvidenceIncomplete

यह ऑब्जेक्ट, सबूत को पूरी तरह से अस्वीकार किए जाने की जानकारी देता है.

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

string

सबूत की जानकारी अधूरी थी. इसका इस्तेमाल सिर्फ़ डीबग करने के लिए किया जाता है.

LowRiskScore

इस टाइप में कोई फ़ील्ड नहीं है.

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

RecordNotFound

इस टाइप में कोई फ़ील्ड नहीं है.

यह ऑब्जेक्ट, रिकॉर्ड नहीं मिलने की वजह से अस्वीकार किए जाने की जानकारी देता है. यह मैसेज जान-बूझकर अभी खाली रखा गया है. आने वाले समय में, नए फ़ील्ड जोड़े जा सकते हैं.

RecordInvalid

यह ऑब्जेक्ट, अमान्य रिकॉर्ड अस्वीकार किए जाने की जानकारी देता है.

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

string

यह जानकारी कि रिकॉर्ड अमान्य क्यों है.

MaxProvisioningsReached

यह ऑब्जेक्ट, ज़्यादा से ज़्यादा संख्या में उपलब्ध कराने की सुविधा के लिए अनुरोध अस्वीकार किए जाने की जानकारी देता है.

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

integer

कार्ड जारी करने वाली कंपनी की नीति के मुताबिक, कार्ड को ज़्यादा से ज़्यादा कितनी बार प्रोविज़न किया जा सकता है.

RiskCheckFailure

इस टाइप में कोई फ़ील्ड नहीं है.

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

LivenessCheckFailure

इस टाइप में कोई फ़ील्ड नहीं है.

यह ऑब्जेक्ट, लाइवनेस की जांच में फ़ेल होने की वजह से अस्वीकार किए जाने की जानकारी देता है. यह मैसेज जान-बूझकर अभी खाली रखा गया है. आने वाले समय में, नए फ़ील्ड जोड़े जा सकते हैं.

चुनौती भरा

यह एक ऐसा ऑब्जेक्ट है जो चुनौती दी गई पुष्टि की स्थिति को दिखाता है.

JSON के काेड में दिखाना 
{
  "challengeDescription": string,

  // Union field challenge can be only one of the following:
  "physicalLocationVisit": {
    object (PhysicalLocationVisit)
  },
  "issuerUrlVisit": {
    object (IssuerUrlVisit)
  },
  "additionalTimeRequired": {
    object (AdditionalTimeRequired)
  }
  // End of list of possible types for union field challenge.
}
फ़ील्ड
challengeDescription

string

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

चेतावनी: इस मैसेज में, व्यक्तिगत पहचान से जुड़ी कोई जानकारी शामिल न करें.
यूनियन फ़ील्ड challenge. ज़रूरी है. यह एक ऐसा विकल्प है जिसमें उपयोगकर्ता को कई चुनौतियों में से किसी एक को पूरा करना पड़ सकता है. challenge इनमें से सिर्फ़ एक हो सकता है:
physicalLocationVisit

object (PhysicalLocationVisit)

ऐसा चैलेंज जिसमें किसी व्यक्ति को चैलेंज पूरा करने के लिए, किसी जगह पर जाना होता है. जैसे, कार्ड जारी करने वाली कंपनी के ऑफ़िस.
issuerUrlVisit

object (IssuerUrlVisit)

यह एक चुनौती वाला विकल्प है. इसमें उपयोगकर्ता को, जारी करने वाले व्यक्ति या कंपनी की ओर से दिए गए यूआरएल पर जाना होता है. साथ ही, उस यूआरएल पर चुनौती पूरी करनी होती है.
additionalTimeRequired

object (AdditionalTimeRequired)

चैलेंज का विकल्प, जिसमें पहचान की पुष्टि करने वाले इस दस्तावेज़ की समीक्षा करने के लिए कुछ और समय चाहिए.

PhysicalLocationVisit

इस टाइप में कोई फ़ील्ड नहीं है.

यह ऑब्जेक्ट, चैलेंज के उस विकल्प को दिखाता है जिसमें किसी व्यक्ति को चैलेंज पूरा करने के लिए, किसी जगह पर जाना होता है. जैसे, कार्ड जारी करने वाली कंपनी के ऑफ़िस. यह चैलेंज, Google के दायरे से बाहर है. सुरक्षा कारणों से, अगर कार्ड जारी करने वाली कंपनी इस तरह के चैलेंज का इस्तेमाल करती है, तो उसे Google को शामिल होने के दौरान लोकेशन की जानकारी देनी होगी.

IssuerUrlVisit

इस टाइप में कोई फ़ील्ड नहीं है.

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

AdditionalTimeRequired

यह चुनौती के विकल्प को दिखाने वाला ऑब्जेक्ट है. इसमें पुष्टि करने के लिए ज़्यादा समय की ज़रूरत होती है. पूरा होने का अनुमानित समय बताना ज़रूरी नहीं है.

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

string (int64 format)

अनुमानित समय, जब प्रूफिंग पूरी हो जाएगी. अगर समीक्षा उपलब्ध है, तो समीक्षा करें. यह टाइमस्टैंप फ़ॉर्मैट में होता है. इसे Unix epoch के बाद से मिलीसेकंड की संख्या के तौर पर दिखाया जाता है.

रद्द किया गया

इस टाइप में कोई फ़ील्ड नहीं है.

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

रद्द की गई

इस टाइप में कोई फ़ील्ड नहीं है.

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

समयसीमा खत्म हो गई है

इस टाइप में कोई फ़ील्ड नहीं है.

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