curl -X PATCH 'https://verification.didit.me/v3/session/11111111-2222-3333-4444-555555555555/add-images/' \
-H 'x-api-key: YOUR_API_KEY' \
-F 'file=@./back-of-id.jpg' \
-F 'model_type=kyc'from didit import Didit
# Reads DIDIT_API_KEY.
client = Didit()
result = client.sessions.add_images(
"11111111-2222-3333-4444-555555555555",
file=open("image.jpg", "rb"),
model_type="kyc",
)
print(result)import Didit, { fileFromPath } from "@didit-protocol/sdk-node";
// Reads DIDIT_API_KEY.
const didit = new Didit();
const result = await didit.sessions.addImages("11111111-2222-3333-4444-555555555555", {
file: await fileFromPath("image.jpg"),
model_type: "kyc",
});
console.log(result);ctx := context.Background()
// Reads DIDIT_API_KEY.
client := didit.NewClient()
result, err := client.Sessions.AddImages(ctx, "11111111-2222-3333-4444-555555555555", didit.SessionsAddImagesParams{
File: didit.FileFromPath("image.jpg"),
ModelType: "kyc",
})
if err != nil {
log.Fatal(err)
}
fmt.Printf("%+v\n", result)import java.nio.file.Path;
import me.didit.Didit;
import me.didit.types.SessionsAddImagesParams;
// Reads DIDIT_API_KEY.
Didit client = new Didit();
var result = client.sessions().addImages("11111111-2222-3333-4444-555555555555", SessionsAddImagesParams.builder()
.file(Path.of("image.jpg"))
.modelType(SessionsAddImagesParams.ModelType.of("kyc"))
.build());
System.out.println(result);<?php
require 'vendor/autoload.php';
use Didit\DiditClient;
use Didit\File;
// Reads DIDIT_API_KEY.
$didit = new DiditClient();
$result = $didit->sessions->addImages('11111111-2222-3333-4444-555555555555', [
'file' => File::fromPath('image.jpg'),
'model_type' => 'kyc',
]);
print_r($result->toArray());require "didit"
# Reads DIDIT_API_KEY.
didit = Didit::Client.new
result = didit.sessions.add_images(
"11111111-2222-3333-4444-555555555555",
file: Pathname("image.jpg"),
model_type: "kyc"
)
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.AddImagesAsync("11111111-2222-3333-4444-555555555555", new SessionsAddImagesParams
{
File = FileUpload.FromPath("image.jpg"),
ModelType = "kyc",
});
Console.WriteLine(JsonSerializer.Serialize(result));{
"extra_files": [
"https://media.example.com/session/11111111-2222-3333-4444-555555555555/kyc-extra-files/66666666-7777-8888-9999-000000000000.jpg?expires=1789383731&signature=abc123"
]
}إضافة صور إلى الجلسة عبر API
أضف صورة أو ملف PDF إضافياً إلى نتيجة التحقق من الهوية أو إثبات العنوان لجلسة KYC منتهية، مثل الوجه الخلفي للمستند، عبر Didit.
curl -X PATCH 'https://verification.didit.me/v3/session/11111111-2222-3333-4444-555555555555/add-images/' \
-H 'x-api-key: YOUR_API_KEY' \
-F 'file=@./back-of-id.jpg' \
-F 'model_type=kyc'from didit import Didit
# Reads DIDIT_API_KEY.
client = Didit()
result = client.sessions.add_images(
"11111111-2222-3333-4444-555555555555",
file=open("image.jpg", "rb"),
model_type="kyc",
)
print(result)import Didit, { fileFromPath } from "@didit-protocol/sdk-node";
// Reads DIDIT_API_KEY.
const didit = new Didit();
const result = await didit.sessions.addImages("11111111-2222-3333-4444-555555555555", {
file: await fileFromPath("image.jpg"),
model_type: "kyc",
});
console.log(result);ctx := context.Background()
// Reads DIDIT_API_KEY.
client := didit.NewClient()
result, err := client.Sessions.AddImages(ctx, "11111111-2222-3333-4444-555555555555", didit.SessionsAddImagesParams{
File: didit.FileFromPath("image.jpg"),
ModelType: "kyc",
})
if err != nil {
log.Fatal(err)
}
fmt.Printf("%+v\n", result)import java.nio.file.Path;
import me.didit.Didit;
import me.didit.types.SessionsAddImagesParams;
// Reads DIDIT_API_KEY.
Didit client = new Didit();
var result = client.sessions().addImages("11111111-2222-3333-4444-555555555555", SessionsAddImagesParams.builder()
.file(Path.of("image.jpg"))
.modelType(SessionsAddImagesParams.ModelType.of("kyc"))
.build());
System.out.println(result);<?php
require 'vendor/autoload.php';
use Didit\DiditClient;
use Didit\File;
// Reads DIDIT_API_KEY.
$didit = new DiditClient();
$result = $didit->sessions->addImages('11111111-2222-3333-4444-555555555555', [
'file' => File::fromPath('image.jpg'),
'model_type' => 'kyc',
]);
print_r($result->toArray());require "didit"
# Reads DIDIT_API_KEY.
didit = Didit::Client.new
result = didit.sessions.add_images(
"11111111-2222-3333-4444-555555555555",
file: Pathname("image.jpg"),
model_type: "kyc"
)
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.AddImagesAsync("11111111-2222-3333-4444-555555555555", new SessionsAddImagesParams
{
File = FileUpload.FromPath("image.jpg"),
ModelType = "kyc",
});
Console.WriteLine(JsonSerializer.Serialize(result));{
"extra_files": [
"https://media.example.com/session/11111111-2222-3333-4444-555555555555/kyc-extra-files/66666666-7777-8888-9999-000000000000.jpg?expires=1789383731&signature=abc123"
]
}extra_files تنتهي صلاحيتها. استرجع روابط جديدة من قرار الجلسة عندما تحتاج إلى الملفات لاحقًا. لتصحيح البيانات المستخرجة من مستند بدلاً من ذلك، استخدم تحديث بيانات الجلسة.التفويضات
مفتاح API الخاص بتطبيقك، من Developers -> API keys في Business Console. يمتلك المفتاح الأساسي وصولاً كاملاً. يمكن تحديد نطاق المفتاح المسمى: لا شيء، أو قراءة، أو كتابة لكل مورد، ومحدوداً ببعض مسارات العمل أو بالجلسات المقبولة، وبقائمة من عناوين IP، وبتاريخ انتهاء الصلاحية. يشير 401 إلى أن المفتاح غير صحيح أو ملغى أو منتهي الصلاحية؛ ويشير 403 إلى أنه لم يتم إرسال أي مفتاح، أو أن المفتاح ليس لديه حق الوصول إلى هذا المورد أو الإجراء، أو أن الطلب جاء من عنوان خارج قائمة عناوين IP الخاصة به؛ ويشير 404 في مسار جلسة إلى أن الجلسة خارج مسارات العمل أو الحالات الخاصة بالمفتاح. يتلقى المفتاح الذي لا يمتلك حق الوصول إلى الوسائط عناوين URL للصور ومقاطع الفيديو وملفات PDF كـ null، ويتلقى المفتاح الذي لا يمتلك إذن كتابة للجلسات روابط الجلسة وtoken كـ null. راجع https://docs.didit.me/console/api-keys.
معلمات المسار
معرّف UUID لجلسة التحقق من المستخدمين (KYC) لإضافة الملف إليها (وهو session_id المُرجع بواسطة POST /v3/session/). يرجع معرّف جلسة التحقق من الشركات (KYB) الرمز 404.
"11111111-2222-3333-4444-555555555555"
الجسم
الصورة أو ملف PDF. الامتدادات المسموح بها: jpg، وjpeg، وpng، وwebp، وtiff، وpdf. بحد أقصى 15 ميغابايت عند الرفع؛ ثم يُضغط الملف ويُرفض برمز 400 إذا ظل حجمه أكبر من 2 ميغابايت (2,097,152 بايت). يتم رفض الملفات الفارغة.
kyc يضيف الملف إلى نتيجة التحقق من الهوية، وpoa إلى نتيجة إثبات العنوان.
kyc, poa "kyc"
كلمة مرور ملف PDF مشفر. بدونها، أو عند إدخال كلمة مرور خاطئة، يُرجع ملف PDF المشفر الرمز 400.
الاستجابة
تمت إضافة الملف. يُرجع كل الملفات الإضافية لتلك النتيجة، بما في ذلك الملف الجديد.
روابط موقعة مسبقاً قصيرة الأجل لجميع الملفات الإضافية للنتيجة المحددة بواسطة model_type، الأقدم أولاً. كل رابط يكون null لمفتاح API ذي نطاق محدد بدون إذن media: read. اقرأ روابط جديدة من قرار الجلسة لاحقاً.