एविडेंस सेट प्राप्त करें
यह बायोमेट्रिक कैप्चर के दौरान जनरेट किय ा गया एविडेंस बंडल लौटाता है — एक पैकेज जिसमें कैप्चर की गई इमेज, मेटाडेटा, और कैप्चर आर्टिफ़ैक्ट्स होते हैं, जो यह साबित करने के लिए इस्तेमाल होते हैं कि लाइवनेस डिटेक्शन नियंत्रित परिस्थितियों में किया गया था।
यह केवल पूर्ण प्रोसेस के लिए उपलब्ध है (state = PROCESS_STATE_FINISHED)।
Endpoint
| Environment | URL |
|---|---|
| Production | GET https://api.idcloud.unico.app/client/v1/process/{processId}/evidenceset |
| Sandbox | GET https://api.idcloud.uat.unico.app/client/v1/process/{processId}/evidenceset |
Request
| Header | Value |
|---|---|
Authorization | Bearer <access_token> (देखें ऑथेंटिकेशन) |
| Parameter | Type | Required | Description |
|---|---|---|---|
processId | string (UUID) | yes | प्रोसेस बनाएं द्वारा लौटाया गया प्रोसेस आइडेंटिफ़ायर। |
Example
- cURL
- Node.js
curl -X GET https://api.idcloud.unico.app/client/v1/process/$PROCESS_ID/evidenceset \
-H "Authorization: Bearer $TOKEN" \
| jq -r .fileContents | base64 --decode > evidence-set.pdf
import { writeFile } from 'node:fs/promises';
async function getEvidenceSet(processId) {
const response = await fetch(
`https://api.idcloud.unico.app/client/v1/process/${processId}/evidenceset`,
{ headers: { Authorization: `Bearer ${accessToken}` } }
);
if (!response.ok) throw new Error(`Get Evidence Set failed with ${response.status}`);
const { fileContents } = await response.json();
// fileContents PDF फ़ाइल है, base64-एन्कोडेड
return Buffer.from(fileContents, 'base64');
}
// PDF को डिस्क पर सेव करें
await writeFile(`evidence-set-${processId}.pdf`, await getEvidenceSet(processId));
// या इसे ब्राउज़र पर भेजें (Express)
app.get('/processes/:id/evidence-set', async (req, res) => {
const pdf = await getEvidenceSet(req.params.id);
res
.type('application/pdf') // contentType को फॉरवर्ड न करें: API "x-pdf" रिटर्न करता है
.set('Content-Disposition', 'inline; filename="evidence-set.pdf"')
.send(pdf);
});
Responses
{
"fileContents": "JVBERi0xLjMNCi...",
"contentType": "x-pdf"
}
| Field | Type | Description |
|---|---|---|
fileContents | string (base64) | एविडेंस सेट PDF, base64-एन्कोडेड। |
contentType | string | वर्तमान में x-pdf रिटर्न करता है। |
x-pdf एक वैध MIME टाइप नहीं है, और ब्राउज़र इसे पहचानते नहीं हैं। contentType को ब्राउज़र पर फॉरवर्ड न करें। fileContents को base64 से डिकोड करें और बाइट्स को application/pdf के रूप में सर्व करें, जैसा ऊपर Node.js उदाहरण में दिखाया गया है।
Error Codes
API इस एंडपॉइंट के लिए विशिष्ट code या message वैल्यू एक्सपोज़ नहीं करता है।
- 400 Bad Request
- 401 Unauthorized
- 404 Not Found
- 500 Internal Server Error
processId पाथ पैरामीटर गायब है या मैलफ़ॉर्म्ड है।
Bearer टोकन गायब, एक्सपायर्ड, या अमान्य है। देखें ऑथेंटिकेशन।
प्रोसेस नहीं मिला, या एविडेंस सेट अभी उपलब्ध नहीं है (प्रोसेस पूरी नहीं हुई)।
| Code | Message | Description |
|---|---|---|
99999 | Internal failure! Try again later | जब कोई इंटरनल एरर होती है। |
What's next
- पूरे प्रोसेस रिज़ल्ट के लिए, देखें प्रोसेस प्राप्त करें।
- कैप्चर की गई सेल्फी इमेज के लिए, देखें सेल्फी प्राप्त करें।