लोकेशन सत्यापन रिपोर्ट: geolocation_checks फ़ील्ड

Overview

सत्र निर्णय दो सूचियों में प्रत्येक Location verification चरण का परिणाम लौटाता है: geolocation_checks[] प्रत्येक चरण के स्वीकृत प्रयास को रखता है, और geolocation_attempts[] क्रम से प्रत्येक प्रयास को सूचीबद्ध करता है। दोनों GET /v3/session/{sessionId}/decision/ पर (देखें सत्र प्राप्त करें) और status.updated webhook में उपलब्ध हैं। बिना किसी Location चरण वाला वर्कफ़्लो दोनों के लिए null या एक खाली सूची लौटाता है।

GET /v3/session/{sessionId}/decision/
  --> { "geolocation_checks": [ { node_id, status, outcome, permission, latitude, longitude, accuracy_m, ... } ],
        "geolocation_attempts": [ { node_id, outcome, attempts, received_at, ... } ] }

`geolocation_checks[]`

प्रति Location चरण (node_id) एक आइटम, जो इसके नवीनतम प्रयास से लिया गया है।

{
  "node_id": "geolocation_1",
  "status": "Declined",
  "outcome": "outside_geofence",
  "permission": "granted_precise",
  "latitude": 48.8566,
  "longitude": 2.3522,
  "accuracy_m": 35.0,
  "accuracy_confidence": "p95",
  "measured_at": "2026-11-03T10:15:02Z",
  "age_seconds": 2,
  "source": "browser",
  "platform": "web",
  "sdk_version": null,
  "is_mock": null,
  "produced_by_accessory": null,
  "integrity": "unsupported",
  "country_code": "FR",
  "region_code": "FR-IDF",
  "city": "Paris",
  "geofence": { "enabled": true, "result": "outside" },
  "inside_geofence": false,
  "geofence_basis": "device",
  "inside_areas": [],
  "blocked_areas": [],
  "position_source": "device_and_ip",
  "anonymizers": { "vpn": false, "proxy": false, "tor": false, "spoofing": null, "emulator": null },
  "ip_distance_km": 0,
  "ip_distance_uncertainty_km": 12.4,
  "ip_consistent": true,
  "document_distance_km": null,
  "travel_excused": null,
  "consecutive_mismatches": 1,
  "attempts": 3,
  "consent": { "accepted_at": "2026-11-03T10:14:55Z", "version": "hosted-web-1", "locale": "en" },
  "warnings": [
    {
      "risk": "LOCATION_OUTSIDE_GEOFENCE",
      "log_type": "error",
      "short_description": "Device location outside the allowed area",
      "node_id": "geolocation_1"
    }
  ]
}

फ़ील्ड	प्रकार	विवरण
`node_id`	string	परिणाम उत्पन्न करने वाला वर्कफ़्लो नोड, ताकि दो Location चरणों वाला वर्कफ़्लो पठनीय बना रहे।
`status`	string	चेतावनियों के आधार पर तय किया गया: `Approved`, `In Review`, `Declined` या `Not Finished`।
`outcome`	string	स्वीकृत प्रयास पर क्या हुआ। देखें परिणाम।
`permission`	string	सिस्टम ने क्या अनुमति दी: `granted_precise`, `granted_approximate`, `denied`, `restricted`, `unavailable`, `timeout`, `dismissed` या `not_requested` (केवल-IP चरण)।
`latitude`, `longitude`	number or null	WGS84 स्थिति। स्थिति न होने पर `null`।
`accuracy_m`	number or null	मीटर में अनिश्चितता का दायरा (त्रिज्या)।
`accuracy_confidence`	string or null	दायरे का विश्वास स्तर: `p95` (web), `p68` (Android) या `unspecified` (iOS)। प्लेटफ़ॉर्म अलग-अलग होते हैं, इसलिए इसे सामान्यीकृत करने के बजाय रिकॉर्ड किया जाता है।
`measured_at`	datetime or null	जब डिवाइस ने डिवाइस क्लॉक के अनुसार स्थिति मापी थी।
`age_seconds`	integer or null	माप और Didit द्वारा इसे प्राप्त किए जाने के क्षण के बीच का समय।
`source`	string or null	`gps`, `fused`, `network`, `wifi`, `cell`, `browser`, `unknown`, या केवल-IP चरण पर `ip`।
`platform`	string or null	`web`, `ios`, `android`, `react_native` या `flutter`।
`sdk_version`	string or null	SDK संस्करण जिसने स्थिति उत्पन्न की।
`is_mock`	boolean or null	सिस्टम ने एक सिम्युलेटेड स्थिति की रिपोर्ट की। `null` का अर्थ है कि प्लेटफ़ॉर्म यह निर्धारित नहीं कर सकता (web), न कि `false`।
`produced_by_accessory`	boolean or null	केवल iOS: स्थिति किसी बाहरी एक्सेसरी से आई थी।
`integrity`	string	डिवाइस अटेस्टेशन: `attested`, `not_attested`, `failed`, `unsupported` (web) या `not_determined`।
`country_code`, `region_code`, `city`	string or null	वह स्थान जिस पर स्थिति निर्धारित होती है, ऑफ़लाइन निकाला गया: ISO 3166-1 alpha-2, ISO 3166-2 और निकटतम आबादी वाला स्थान। शहर समीक्षकों के लिए एक लेबल है, कभी भी नियम इनपुट नहीं।
`geofence`	object	`enabled`, और `result`: `inside`, `outside` या `undetermined`। जियोफ़ेंसिंग बंद होने पर `result` मान `null` होता है।
`inside_geofence`	boolean or null	`true` या `false`, और जियोफ़ेंसिंग बंद होने पर या सटीकता का वृत्त किसी सीमा को काटता हो तब `null`।
`geofence_basis`	string or null	क्षेत्र निर्णय के लिए किस स्थिति का उपयोग किया गया: `device` या `ip`।
`inside_areas`, `blocked_areas`	array	उन अनुमत क्षेत्रों के `id`s जिनके अंदर पूरा सटीकता दायरा है, और उन अवरुद्ध क्षेत्रों के जिनके अंदर यह स्थित है।
`position_source`	string or null	प्रयास चलने के समय नोड का `geolocation_position_source`।
`anonymizers`	object or null	`vpn`, `proxy`, `tor`, `spoofing` और `emulator`, प्रत्येक `true`, `false` या जब स्रोत निर्धारित नहीं कर सकता तो `null`।
`ip_distance_km`	number or null	दोनों अनिश्चितता त्रिज्याओं को घटाने के बाद IP स्थान की दूरी। 0 का अर्थ है कि वे ओवरलैप करते हैं।
`ip_distance_uncertainty_km`	number or null	घटाई गई संयुक्त त्रिज्या।
`ip_consistent`	boolean or null	`ip_distance_km` मान `geolocation_ip_distance_km` के भीतर है। दोनों में से किसी एक पक्ष के अज्ञात होने पर `null`।
`document_distance_km`	number or null	जियोकोडेड दस्तावेज़ पते की दूरी। रिकॉर्ड में कोई पता न होने पर `null`।
`travel_excused`	boolean or null	यात्रा सहिष्णुता के कारण दूरी को छूट मिली। सहिष्णुता बंद होने पर `null`।
`consecutive_mismatches`	integer or null	अंतिम प्रयास पर इस जाँच समेत उसी व्यक्ति के लगातार पिछले बेमेलों की संख्या।
`attempts`	integer	प्रयास की संख्या।
`consent`	object or null	व्यक्ति द्वारा स्वीकार की गई स्थान सूचना का `accepted_at`, `version` और `locale`।
`warnings`	array	चरण की चेतावनियाँ।

`geolocation_attempts[]`

प्रत्येक Location चरण का प्रत्येक प्रयास, सबसे पुराना पहले, warnings को छोड़कर geolocation_checks[] के समान माप, अनिश्चितता, क्षेत्र और दूरी फ़ील्ड के साथ, साथ ही:

फ़ील्ड	प्रकार	विवरण
`received_at`	datetime	जब Didit को प्रयास प्राप्त हुआ।
`created_at`	datetime	जब प्रयास रिकॉर्ड किया गया था।

पुनः सबमिशन द्वारा अप्रचलित किए गए प्रयासों को शामिल नहीं किया जाता। कच्चा क्लाइंट सबमिशन और चैलेंज कभी नहीं लौटाए जाते हैं।

स्थिति नियमों और शाखाओं के लिए फ़ील्ड

कस्टम status_rules और शाखा नियम इन फ़ील्ड को पढ़ सकते हैं: geolocation.status, geolocation.outcome, geolocation.permission, geolocation.latitude, geolocation.longitude, geolocation.accuracy_m, geolocation.accuracy_confidence, geolocation.age_seconds, geolocation.measured_at, geolocation.source, geolocation.platform, geolocation.country (ISO 3166-1 alpha-3), geolocation.region, geolocation.city, geolocation.is_mock, geolocation.integrity, geolocation.inside_geofence, geolocation.ip_distance_km, geolocation.ip_consistent, geolocation.document_distance_km, geolocation.attempts, geolocation.consent_at, geolocation.inside_areas, geolocation.blocked_areas, geolocation.anonymizers (vpn, proxy, tor, spoofing, emulator) और geolocation.consecutive_mismatches। एक अनुपलब्ध मान केवल is_empty से मेल खाता है, इसलिए धोखाधड़ी सिग्नल के लिए लिखा गया नियम कभी भी अनुपलब्ध डेटा पर ट्रिगर नहीं होता है।

प्रमाणीकरण

सत्यापन

निगरानी

प्लेटफ़ॉर्म

लोकेशन सत्यापन रिपोर्ट: geolocation_checks फ़ील्ड

Overview

`geolocation_checks[]`

`geolocation_attempts[]`

स्थिति नियमों और शाखाओं के लिए फ़ील्ड

संबंधित

​Overview

​geolocation_checks[]

​geolocation_attempts[]

​स्थिति नियमों और शाखाओं के लिए फ़ील्ड

​संबंधित

Overview

`geolocation_checks[]`

`geolocation_attempts[]`

स्थिति नियमों और शाखाओं के लिए फ़ील्ड

संबंधित