curl -X GET 'https://verification.didit.me/v3/session/11111111-2222-3333-4444-555555555555/files-export/aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee/' \
-H 'x-api-key: YOUR_API_KEY'from didit import Didit
# Reads DIDIT_API_KEY.
client = Didit()
result = client.sessions.get_files_export(
"11111111-2222-3333-4444-555555555555",
"aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee",
)
print(result)import Didit from "@didit-protocol/sdk-node";
// Reads DIDIT_API_KEY.
const didit = new Didit();
const result = await didit.sessions.getFilesExport(
"11111111-2222-3333-4444-555555555555",
"aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee",
);
console.log(result);ctx := context.Background()
// Reads DIDIT_API_KEY.
client := didit.NewClient()
result, err := client.Sessions.GetFilesExport(ctx, "11111111-2222-3333-4444-555555555555", "aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee")
if err != nil {
log.Fatal(err)
}
fmt.Printf("%+v\n", result)import me.didit.Didit;
// Reads DIDIT_API_KEY.
Didit client = new Didit();
var result = client.sessions().getFilesExport("11111111-2222-3333-4444-555555555555", "aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee");
System.out.println(result);<?php
require 'vendor/autoload.php';
use Didit\DiditClient;
// Reads DIDIT_API_KEY.
$didit = new DiditClient();
$result = $didit->sessions->getFilesExport('11111111-2222-3333-4444-555555555555', 'aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee');
print_r($result->toArray());require "didit"
# Reads DIDIT_API_KEY.
didit = Didit::Client.new
result = didit.sessions.get_files_export(
"11111111-2222-3333-4444-555555555555",
"aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee"
)
puts result.to_husing System;
using System.Text.Json;
using Didit;
// Reads DIDIT_API_KEY.
using var client = new DiditClient();
var result = await client.Sessions.GetFilesExportAsync("11111111-2222-3333-4444-555555555555", "aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee");
Console.WriteLine(JsonSerializer.Serialize(result));{
"export_id": "aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee",
"session_id": "11111111-2222-3333-4444-555555555555",
"status": "READY",
"file_count": 9,
"size_bytes": 18734120,
"download_url": "https://storage.example.com/session/11111111-2222-3333-4444-555555555555/files-export/aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee/session-42-files.zip?X-Amz-Signature=...",
"expires_at": "2026-10-30T12:00:41Z",
"error": null,
"created_at": "2026-10-29T12:00:03Z",
"completed_at": "2026-10-29T12:00:41Z"
}تصدير ملفات الجلسة: الحالة ورابط التنزيل عبر API
في Didit، اقرأ حالة تصدير ملفات الجلسة واحصل على رابط تنزيل موقّع لملف ZIP فور جاهزيته (GET /v3/session//files-export//).
curl -X GET 'https://verification.didit.me/v3/session/11111111-2222-3333-4444-555555555555/files-export/aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee/' \
-H 'x-api-key: YOUR_API_KEY'from didit import Didit
# Reads DIDIT_API_KEY.
client = Didit()
result = client.sessions.get_files_export(
"11111111-2222-3333-4444-555555555555",
"aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee",
)
print(result)import Didit from "@didit-protocol/sdk-node";
// Reads DIDIT_API_KEY.
const didit = new Didit();
const result = await didit.sessions.getFilesExport(
"11111111-2222-3333-4444-555555555555",
"aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee",
);
console.log(result);ctx := context.Background()
// Reads DIDIT_API_KEY.
client := didit.NewClient()
result, err := client.Sessions.GetFilesExport(ctx, "11111111-2222-3333-4444-555555555555", "aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee")
if err != nil {
log.Fatal(err)
}
fmt.Printf("%+v\n", result)import me.didit.Didit;
// Reads DIDIT_API_KEY.
Didit client = new Didit();
var result = client.sessions().getFilesExport("11111111-2222-3333-4444-555555555555", "aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee");
System.out.println(result);<?php
require 'vendor/autoload.php';
use Didit\DiditClient;
// Reads DIDIT_API_KEY.
$didit = new DiditClient();
$result = $didit->sessions->getFilesExport('11111111-2222-3333-4444-555555555555', 'aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee');
print_r($result->toArray());require "didit"
# Reads DIDIT_API_KEY.
didit = Didit::Client.new
result = didit.sessions.get_files_export(
"11111111-2222-3333-4444-555555555555",
"aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee"
)
puts result.to_husing System;
using System.Text.Json;
using Didit;
// Reads DIDIT_API_KEY.
using var client = new DiditClient();
var result = await client.Sessions.GetFilesExportAsync("11111111-2222-3333-4444-555555555555", "aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee");
Console.WriteLine(JsonSerializer.Serialize(result));{
"export_id": "aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee",
"session_id": "11111111-2222-3333-4444-555555555555",
"status": "READY",
"file_count": 9,
"size_bytes": 18734120,
"download_url": "https://storage.example.com/session/11111111-2222-3333-4444-555555555555/files-export/aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee/session-42-files.zip?X-Amz-Signature=...",
"expires_at": "2026-10-30T12:00:41Z",
"error": null,
"created_at": "2026-10-29T12:00:03Z",
"completed_at": "2026-10-29T12:00:41Z"
}PENDINGوPROCESSING: يجري إعداد ملف ZIP. اقرأ التصدير مرة أخرى بعد بضع ثوانٍ.READY:download_urlرابط موقّع إلى ملف ZIP يبقى صالحًا لمدة قصيرة. اقرأ التصدير مرة أخرى للحصول على رابط جديد حتىexpires_at.FAILED: تعذّر إعداد ملف ZIP. ابدأ تصديرًا جديدًا.EXPIRED: تم حذف ملف ZIP. ابدأ تصديرًا جديدًا.
404.التفويضات
مفتاح API الخاص بتطبيقك، من Developers -> API keys في Business Console. يمتلك المفتاح الأساسي وصولاً كاملاً. يمكن تحديد نطاق المفتاح المسمى: لا شيء، أو قراءة، أو كتابة لكل مورد، ومحدوداً ببعض مسارات العمل أو بالجلسات المقبولة، وبقائمة من عناوين IP، وبتاريخ انتهاء الصلاحية. يشير 401 إلى أن المفتاح غير صحيح أو ملغى أو منتهي الصلاحية؛ ويشير 403 إلى أنه لم يتم إرسال أي مفتاح، أو أن المفتاح ليس لديه حق الوصول إلى هذا المورد أو الإجراء، أو أن الطلب جاء من عنوان خارج قائمة عناوين IP الخاصة به؛ ويشير 404 في مسار جلسة إلى أن الجلسة خارج مسارات العمل أو الحالات الخاصة بالمفتاح. يتلقى المفتاح الذي لا يمتلك حق الوصول إلى الوسائط عناوين URL للصور ومقاطع الفيديو وملفات PDF كـ null، ويتلقى المفتاح الذي لا يمتلك إذن كتابة للجلسات روابط الجلسة وtoken كـ null. راجع https://docs.didit.me/console/api-keys.
معلمات المسار
معرّف UUID لجلسة التحقق (session_id الذي تم إرجاعه بواسطة POST /v3/session/). يقبل معرّفات جلسات التحقق من المستخدمين (KYC) والتحقق من الشركات (KYB). تُرجع الجلسة المحذوفة 404.
"11111111-2222-3333-4444-555555555555"
معرّف export_id الذي تم إرجاعه بواسطة POST /v3/session/{sessionId}/files-export/.
"aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee"
الاستجابة
التصدير.
ملف ZIP واحد يحتوي على كل ملفات الجلسة، بالجودة الأصلية.
معرّف التصدير. مرره إلى GET /v3/session/{sessionId}/files-export/{exportId}/.
الجلسة التي تنتمي إليها الملفات.
PENDING وPROCESSING أثناء إعداد ملف ZIP، وREADY بمجرد أن يصبح قابلاً للتنزيل، وFAILED عندما يتعذر إعداده (اطلب عملية تصدير جديدة)، وEXPIRED بمجرد حذف ملف ZIP.
PENDING, PROCESSING, READY, FAILED, EXPIRED الملفات الموجودة في ملف ZIP. تُعيّن فقط عندما تكون status هي READY.
حجم ملف ZIP بالبايت. يُعيَّن فقط عندما تكون status هي READY.
رابط URL موقّع لملف ZIP، صالح لفترة قصيرة. يُعيَّن فقط عندما تكون status هي READY؛ اقرأ التصدير مجدداً للحصول على رابط جديد.
وقت حذف ملف ZIP، بعد 24 ساعة من جاهزيته. لا يُعيَّن إلا عندما تكون status هي READY.
سبب فشل التصدير، عندما تكون قيمة status هي FAILED.
وقت طلب التصدير.
وقت جاهزية ملف ZIP أو فشل التصدير.