> ## Documentation Index
> Fetch the complete documentation index at: https://docs.didit.me/llms.txt
> Use this file to discover all available pages before exploring further.

# बायोमेट्रिक प्रमाणीकरण रिपोर्ट: JSON स्कीमा

> Didit बायोमेट्रिक प्रमाणीकरण रिपोर्ट पार्स करें, जिसमें liveness_checks और face_matches के ज़रिए लाइवनेस और चेहरा मिलान मिलता है।

बायोमेट्रिक प्रमाणीकरण रिपोर्ट के माध्यम से Didit वापस लौटने वाले उपयोगकर्ता के पुनः सत्यापन की रिपोर्ट करता है। यह वर्कफ़्लो एक नया लाइवनेस चेक चलाता है और, जब वर्कफ़्लो में चेहरा मिलान सक्षम होता है, तो सत्र निर्माण के समय निर्धारित संदर्भ चेहरे (आपके द्वारा प्रदान की गई `portrait_image`, या `vendor_data` के ज़रिए खोजा गया उपयोगकर्ता का संग्रहीत चेहरा) के विरुद्ध 1:1 चेहरा मिलान करता है। दोनों चेक V3 सत्र निर्णय रिस्पॉन्स में मानक सुविधा आइटम के रूप में दिखाई देते हैं।

![संग्रहीत पोर्ट्रेट के विरुद्ध लाइवनेस चेक और चेहरा मिलान को संयोजित करने वाली Didit बायोमेट्रिक प्रमाणीकरण रिपोर्ट](https://mintcdn.com/didit-0f962782/z6T2GHM4Zh-iSj-K/images/biometric-auth-report.png?fit=max\&auto=format\&n=z6T2GHM4Zh-iSj-K\&q=85\&s=c02e5558780972797d4b2feea685bc73)

## अवलोकन

बायोमेट्रिक प्रमाणीकरण एक वर्कफ़्लो प्रकार (`workflow_type: "biometric_authentication"`) है, कोई अलग रिस्पॉन्स ऑब्जेक्ट नहीं। जब वर्कफ़्लो चलता है तो यह जनरेट करता है:

* एक **लाइवनेस चेक** जो एक लाइव सेल्फ़ी कैप्चर करता है और स्पूफिंग के लिए इसे स्कोर करता है।
* एक **चेहरा मिलान** जो कैप्चर किए गए चेहरे की तुलना सत्र निर्माण के समय निर्धारित संदर्भ चेहरे से करता है (केवल तभी जब वर्कफ़्लो में चेहरा मिलान सक्षम हो)।

जब भी वर्कफ़्लो में चेहरा मिलान शामिल होता है, सत्र निर्माण के लिए एक संदर्भ चेहरे की आवश्यकता होती है। `portrait_image` (base64-एनकोडेड इमेज, अधिकतम 2MB) भेजें, या इसे छोड़ दें और Didit `vendor_data` उपयोगकर्ता के लिए पहले से संग्रहीत चेहरे का पुनः उपयोग करता है: पहले एक स्वीकृत लाइवनेस चेहरा, फिर ePassport चिप फ़ोटो, फिर पहचान दस्तावेज़ का पोर्ट्रेट, फिर मैन्युअल रूप से दर्ज किया गया प्रोफ़ाइल चेहरा। यदि न तो `portrait_image` और न ही कोई संग्रहीत चेहरा उपलब्ध है, तो सत्र निर्माण `400` लौटाता है जिसमें `{"portrait_image": "No stored face image was found for this user. Send a portrait_image, or complete an approved verification with face liveness or an ID document for this vendor_data first."}` शामिल होता है। दोनों ही मामलों में निर्धारित संदर्भ नए सत्र के तहत रिकॉर्ड किया जाता है, इसलिए चेहरा मिलान आइटम का `source_image_session_id` उस सत्र के अपने `session_id` पर सेट होता है (यह आपको बताता है कि संदर्भ उसी सत्र में कैप्चर किए गए दस्तावेज़ पोर्ट्रेट के बजाय सत्र के संग्रहीत पोर्ट्रेट से आया है, जो इस फ़ील्ड को `null` छोड़ देगा)।

## यह कहाँ दिखाई देता है

| निर्णय रिस्पॉन्स कुंजी | बहुवचन | आइटम स्कीमा |
| - | - | - |
| `liveness_checks[]` | प्रति लाइवनेस चरण एक (बायोमेट्रिक प्रमाणीकरण में आमतौर पर 1) | [data-models#liveness-check](https://docs.didit.me/hi/reference/data-models.md#लाइवनेस-जाँच) |
| `face_matches[]` | प्रति चेहरा मिलान चरण एक (केवल-लाइवनेस वर्कफ़्लो में `null`) | [data-models#face-match](https://docs.didit.me/hi/reference/data-models.md#चेहरा-मिलान) |

दोनों ऐरे उन सत्रों के लिए [`GET /v3/session/{sessionId}/decision/`](https://docs.didit.me/hi/sessions-api/retrieve-session) द्वारा लौटाए जाते हैं जिनका वर्कफ़्लो प्रकार `biometric_authentication` है। वे हमेशा ऐरे होते हैं — कभी भी एकल ऑब्जेक्ट नहीं — और प्रत्येक तब तक `null` रहता है जब तक कि उसके चरण ने डेटा जनरेट न कर दिया हो। प्रत्येक आइटम में एक `node_id` होता है, ताकि बहु-इंस्टेंस वर्कफ़्लो में चरणों की पहचान अलग-अलग की जा सके।

## स्कीमा संदर्भ

पूरी फ़ील्ड सूची डेटा-मॉडल पेज पर एक बार परिभाषित की गई है ताकि इन सुविधाओं को प्रदर्शित करने वाली प्रत्येक रिपोर्ट एकमात्र विश्वसनीय स्रोत साझा करे:

* [लाइवनेस आइटम स्कीमा](https://docs.didit.me/hi/reference/data-models.md#लाइवनेस-जाँच) — `status`, `method`, `score`, `reference_image`, `video_url`, `age_estimation`, `matches[]`, `face_quality`, `face_luminance`, `warnings[]`, `node_id`।
* [चेहरा मिलान आइटम स्कीमा](https://docs.didit.me/hi/reference/data-models.md#चेहरा-मिलान) — `status`, `score`, `source_image_session_id`, `source_image`, `target_image`, `warnings[]`, `node_id`।
* [चेतावनी प्रविष्टि संरचना](https://docs.didit.me/hi/reference/data-models.md#चेतावनी-ऑब्जेक्ट) — `feature`, `risk`, `additional_data`, `log_type`, `short_description`, `long_description`, `node_id`।

## स्टेटस मान

`liveness_checks[].status` और `face_matches[].status` दोनों साझा सुविधा जीवनचक्र ([सुविधा-स्तरीय स्थितियाँ](https://docs.didit.me/hi/reference/data-models.md#सुविधा-स्तरीय-स्टेटस)) का उपयोग करते हैं:

| स्टेटस | अर्थ |
| - | - |
| `Not Finished` | चरण ने अभी तक कोई अंतिम परिणाम नहीं दिया है (उपयोगकर्ता ने इसे पूरा नहीं किया है, या छोड़ दिया है)। किसी चरण के शुरू होने से पहले, निर्णय रिस्पॉन्स में उसका ऐरे केवल `null` होता है। |
| `Approved` | चेक ने सभी कॉन्फ़िगर किए गए थ्रेशोल्ड पास कर लिए। |
| `In Review` | स्कोर समीक्षा बैंड में आ गया, या एक कॉन्फ़िगरेबल चेतावनी को समीक्षा पर सेट किया गया था। |
| `Declined` | स्कोर अस्वीकृति थ्रेशोल्ड पर या उससे नीचे गिर गया, या एक ऑटो-अस्वीकृति चेतावनी ट्रिगर हो गई (फ़ेस अटैक, कोई चेहरा नहीं मिला, चेहरा ब्लॉकलिस्ट में है, चेहरा मिलान के लिए कोई संदर्भ छवि नहीं)। |
| `Resub Requested` | एक समीक्षक ने उपयोगकर्ता से इस चरण का पुनः प्रयास करने के लिए कहा। |

समग्र सत्र `status` दोनों आइटम को जोड़ता है: `Declined` में कोई भी सुविधा सत्र को अस्वीकृत कर देती है, `In Review` में कोई भी सुविधा सत्र को `In Review` में डाल देती है, अन्यथा `Approved` (प्रत्येक सुविधा समाप्त होने के बाद)।

थ्रेशोल्ड व्यवहार और चेतावनी कोड की पूरी सूची के लिए, [बायोमेट्रिक प्रमाणीकरण चेतावनियाँ](https://docs.didit.me/hi/core-technology/biometric-auth/warnings-biometric-authentication.md) देखें।

## उदाहरण — लाइवनेस + चेहरा मिलान (स्वीकृत)

उदाहरण संक्षिप्त हैं: पूर्ण निर्णय एन्वेलप में `session_url`, `metadata`, `callback`, `reviews`, `contact_details`, `expected_details`, `environment`, `created_at`, और `expires_at` भी शामिल होते हैं।

```json theme={null}
{
  "session_id": "11111111-2222-3333-4444-555555555555",
  "session_kind": "user",
  "session_number": 1234,
  "status": "Approved",
  "workflow_id": "018e7b2c-5555-7777-9999-aaaaaaaaaaaa",
  "features": ["LIVENESS", "FACE_MATCH"],
  "vendor_data": "user-123",
  "liveness_checks": [
    {
      "node_id": "feature_liveness",
      "status": "Approved",
      "method": "PASSIVE",
      "score": 89.92,
      "reference_image": "https://<media-host>/.../reference.jpg",
      "video_url": "https://<media-host>/.../video.mp4",
      "age_estimation": null,
      "matches": [],
      "face_quality": 92.4,
      "face_luminance": 58.1,
      "warnings": []
    }
  ],
  "face_matches": [
    {
      "node_id": "feature_face_match",
      "status": "Approved",
      "score": 88.47,
      "source_image_session_id": "11111111-2222-3333-4444-555555555555",
      "source_image": "https://<media-host>/.../source.jpg",
      "target_image": "https://<media-host>/.../target.jpg",
      "warnings": []
    }
  ],
  "id_verifications": null,
  "nfc_verifications": null,
  "poa_verifications": null,
  "phone_verifications": null,
  "email_verifications": null,
  "aml_screenings": null
}
```

## उदाहरण — केवल-लाइवनेस (वर्कफ़्लो में चेहरा मिलान अक्षम)

```json theme={null}
{
  "session_id": "22222222-3333-4444-5555-666666666666",
  "session_kind": "user",
  "status": "Approved",
  "workflow_id": "018e7b2c-6666-7777-9999-bbbbbbbbbbbb",
  "features": ["LIVENESS"],
  "vendor_data": "user-456",
  "liveness_checks": [
    {
      "node_id": "feature_liveness",
      "status": "Approved",
      "method": "ACTIVE_3D",
      "score": 96.10,
      "reference_image": "https://<media-host>/.../reference.jpg",
      "video_url": "https://<media-host>/.../video.mp4",
      "age_estimation": null,
      "matches": [],
      "face_quality": null,
      "face_luminance": null,
      "warnings": []
    }
  ],
  "face_matches": null
}
```

केवल-लाइवनेस मोड एक वर्कफ़्लो कॉन्फ़िगरेशन है: जब चेहरा मिलान अक्षम होता है, तो सत्र निर्माण के समय किसी संदर्भ चेहरे की आवश्यकता नहीं होती है और `face_matches` `null` रहता है। जब चेहरा मिलान सक्षम **होता है**, तो `portrait_image` को छोड़ने से यह केवल-लाइवनेस पर वापस नहीं जाता है: Didit `vendor_data` उपयोगकर्ता के लिए संग्रहीत चेहरे का पुनः उपयोग करता है, और यदि कोई संग्रहीत चेहरा मौजूद नहीं है तो सत्र निर्माण `400` के साथ विफल हो जाता है।

## उदाहरण — कम समानता पर चेहरा मिलान अस्वीकृत

```json theme={null}
{
  "session_id": "33333333-4444-5555-6666-777777777777",
  "status": "Declined",
  "workflow_id": "018e7b2c-5555-7777-9999-aaaaaaaaaaaa",
  "liveness_checks": [
    {
      "node_id": "feature_liveness",
      "status": "Approved",
      "method": "PASSIVE",
      "score": 91.20,
      "reference_image": "https://<media-host>/.../reference.jpg",
      "video_url": "https://<media-host>/.../video.mp4",
      "age_estimation": null,
      "matches": [],
      "face_quality": 90.15,
      "face_luminance": 55.30,
      "warnings": []
    }
  ],
  "face_matches": [
    {
      "node_id": "feature_face_match",
      "status": "Declined",
      "score": 41.18,
      "source_image_session_id": "33333333-4444-5555-6666-777777777777",
      "source_image": "https://<media-host>/.../source.jpg",
      "target_image": "https://<media-host>/.../target.jpg",
      "warnings": [
        {
          "feature": "FACEMATCH",
          "risk": "LOW_FACE_MATCH_SIMILARITY",
          "additional_data": null,
          "log_type": "error",
          "short_description": "Low face match similarity",
          "long_description": "The facial features of the provided image don't closely match the reference image, suggesting a potential identity mismatch.",
          "node_id": "feature_face_match"
        }
      ]
    }
  ]
}
```

## सुरक्षा नोट

`reference_image`, `video_url`, `source_image`, और `target_image` हस्ताक्षरित URL हैं जो एक सीमित वैधता विंडो (डिफ़ॉल्ट रूप से 4 घंटे) के बाद समाप्त हो जाते हैं। वे बायोमेट्रिक डेटा की ओर संकेत करते हैं — उन्हें सार्वजनिक रूप से कैश या प्रदर्शित न करें। अपने पक्ष में सत्यापन परिणाम (status, score, `source_image_session_id`) संग्रहीत करें; यदि आपको नए URL की आवश्यकता हो तो निर्णय endpoint को फिर से कॉल करें।

## संबंधित

> [card] [बायोमेट्रिक प्रमाणीकरण चेतावनियाँ](https://docs.didit.me/hi/core-technology/biometric-auth/warnings-biometric-authentication.md)
>
> चेतावनी कोड, थ्रेशोल्ड, और स्वचालित अस्वीकृति शर्तें।

> [card] [लाइवनेस रिपोर्ट](https://docs.didit.me/hi/core-technology/liveness/report-liveness.md)
>
> `liveness_checks[]` आइटम के लिए पूर्ण फ़ील्ड संदर्भ।

> [card] [चेहरा मिलान रिपोर्ट](https://docs.didit.me/hi/core-technology/face-match/report-face-match.md)
>
> `face_matches[]` आइटम के लिए पूर्ण फ़ील्ड संदर्भ।


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.