ابدأ الآن
التكامل / SDKs
التحقق من المستخدمين
التحقق من الشركات
مراقبة المعاملات
سجل التغييراتcurl -X PATCH 'https://verification.didit.me/v3/users/user-abc-123/update-status/' \
-H 'x-api-key: YOUR_API_KEY' \
-H 'Content-Type: application/json' \
-d '{"status": "BLOCKED"}'from didit import Didit
# Reads DIDIT_API_KEY.
client = Didit()
result = client.users.update_status(
"user-123",
status="ACTIVE",
)
print(result)import Didit from "@didit-protocol/sdk-node";
// Reads DIDIT_API_KEY.
const didit = new Didit();
const result = await didit.users.updateStatus("user-123", {
status: "ACTIVE",
});
console.log(result);ctx := context.Background()
// Reads DIDIT_API_KEY.
client := didit.NewClient()
result, err := client.Users.UpdateStatus(ctx, "user-123", didit.UsersUpdateStatusParams{
Status: "ACTIVE",
})
if err != nil {
log.Fatal(err)
}
fmt.Printf("%+v\n", result)import me.didit.Didit;
import me.didit.types.EntityStatusUpdateRequest;
import me.didit.types.UsersUpdateStatusParams;
// Reads DIDIT_API_KEY.
Didit client = new Didit();
var result = client.users().updateStatus("user-123", UsersUpdateStatusParams.builder()
.status(EntityStatusUpdateRequest.Status.of("ACTIVE"))
.build());
System.out.println(result);<?php
require 'vendor/autoload.php';
use Didit\DiditClient;
// Reads DIDIT_API_KEY.
$didit = new DiditClient();
$result = $didit->users->updateStatus('user-123', [
'status' => 'ACTIVE',
]);
print_r($result->toArray());require "didit"
# Reads DIDIT_API_KEY.
didit = Didit::Client.new
result = didit.users.update_status(
"user-123",
status: "ACTIVE"
)
puts result.to_husing System;
using System.Text.Json;
using Didit;
// Reads DIDIT_API_KEY.
using var client = new DiditClient();
var result = await client.Users.UpdateStatusAsync("user-123", new UsersUpdateStatusParams
{
Status = "ACTIVE",
});
Console.WriteLine(JsonSerializer.Serialize(result));واجهة تحديث حالة المستخدم API: حظر المستخدم أو تمييزه
حظر مستخدم Didit أو تمييزه أو تفعيله. تنتقل الحالة إلى جلسات KYC المقبلة وفحص المعاملات. إدارة المستخدمين بالدفع لكل استدعاء.
curl -X PATCH 'https://verification.didit.me/v3/users/user-abc-123/update-status/' \
-H 'x-api-key: YOUR_API_KEY' \
-H 'Content-Type: application/json' \
-d '{"status": "BLOCKED"}'from didit import Didit
# Reads DIDIT_API_KEY.
client = Didit()
result = client.users.update_status(
"user-123",
status="ACTIVE",
)
print(result)import Didit from "@didit-protocol/sdk-node";
// Reads DIDIT_API_KEY.
const didit = new Didit();
const result = await didit.users.updateStatus("user-123", {
status: "ACTIVE",
});
console.log(result);ctx := context.Background()
// Reads DIDIT_API_KEY.
client := didit.NewClient()
result, err := client.Users.UpdateStatus(ctx, "user-123", didit.UsersUpdateStatusParams{
Status: "ACTIVE",
})
if err != nil {
log.Fatal(err)
}
fmt.Printf("%+v\n", result)import me.didit.Didit;
import me.didit.types.EntityStatusUpdateRequest;
import me.didit.types.UsersUpdateStatusParams;
// Reads DIDIT_API_KEY.
Didit client = new Didit();
var result = client.users().updateStatus("user-123", UsersUpdateStatusParams.builder()
.status(EntityStatusUpdateRequest.Status.of("ACTIVE"))
.build());
System.out.println(result);<?php
require 'vendor/autoload.php';
use Didit\DiditClient;
// Reads DIDIT_API_KEY.
$didit = new DiditClient();
$result = $didit->users->updateStatus('user-123', [
'status' => 'ACTIVE',
]);
print_r($result->toArray());require "didit"
# Reads DIDIT_API_KEY.
didit = Didit::Client.new
result = didit.users.update_status(
"user-123",
status: "ACTIVE"
)
puts result.to_husing System;
using System.Text.Json;
using Didit;
// Reads DIDIT_API_KEY.
using var client = new DiditClient();
var result = await client.Users.UpdateStatusAsync("user-123", new UsersUpdateStatusParams
{
Status = "ACTIVE",
});
Console.WriteLine(JsonSerializer.Serialize(result));نظرة عامة
ينقل كيان المستخدم بينACTIVE وFLAGGED وBLOCKED. راجع دورة حياة الكيان للاطلاع على آلة الحالات كاملة.
متى تستخدمه
- حظر مستخدم بعد التأكد من وجود احتيال أو خرق للامتثال.
- وضع علامة على مستخدم بانتظار المراجعة اليدوية دون حظره حظراً كاملاً.
- إلغاء الحظر عن مستخدم بعد معالجة الوضع بنجاح.
- نقل الإشارات الخارجية: مثلاً عندما يمنح محرك الاحتيال الخاص بك مستخدماً درجة أعلى من الحد، انقله إلى
FLAGGEDعبر هذه الواجهة.
ملاحظات
- القيم الصالحة هي
ACTIVEوFLAGGEDوBLOCKED. القيم غير الصالحة تُرجع 400. - مرّر
reasonاختيارياً (حتى 1000 حرف) لتسجيل سبب تغيير الحالة. يحتفظ Didit به كتعليق على إدخال تغيير الحالة في نشاط الشخص:comments[].commentفي المستخدم، والنشاط في Business Console. يُسجَّل فقط عندما تتغير الحالة فعلاً. - تُرفض تلقائياً جميع الجلسات الجديدة وجميع المعاملات الجديدة للمستخدمين في حالة
BLOCKED. - يُصدر webhook من نوع
user.status.updatedمعprevious_statusوstatus. لا يتضمن webhook الحقلreason.
الإنفاذ
| الحالة | الأثر على الجلسات الجديدة | الأثر على المعاملات الجديدة |
|---|---|---|
ACTIVE | المسار العادي | المسار العادي |
FLAGGED | مسموح بها لكن تُوجَّه إلى IN_REVIEW | مسموح بها؛ قد تُصعَّد تلقائياً حسب القواعد |
BLOCKED | رفض تلقائي | رفض تلقائي |
الأذونات
يمكن للمفتاح السري الرئيسي ومفاتيح API ذات الصلاحيات الكاملة استدعاء هذا endpoint في أي وقت. يحتاج المفتاح ذو الوصول المخصص إلى صلاحية الكتابة على الأشخاص (users).
لا يستطيع المفتاح المقيّد ببعض سير العمل أو بالجلسات المعتمدة الوصول إلى هذا endpoint.
تحدد الأدوار والأذونات في Console ما يمكن لعضو الفريق فعله داخل Console.
لا تُقيَّم هذه الأذونات لطلبات مفاتيح API.
ذات صلة
التفويضات
مفتاح API الخاص بتطبيقك، من Developers -> API keys في Business Console. يمتلك المفتاح الأساسي وصولاً كاملاً. يمكن تحديد نطاق المفتاح المسمى: لا شيء، أو قراءة، أو كتابة لكل مورد، ومحدوداً ببعض مسارات العمل أو بالجلسات المقبولة، وبقائمة من عناوين IP، وبتاريخ انتهاء الصلاحية. يشير 401 إلى أن المفتاح غير صحيح أو ملغى أو منتهي الصلاحية؛ ويشير 403 إلى أنه لم يتم إرسال أي مفتاح، أو أن المفتاح ليس لديه حق الوصول إلى هذا المورد أو الإجراء، أو أن الطلب جاء من عنوان خارج قائمة عناوين IP الخاصة به؛ ويشير 404 في مسار جلسة إلى أن الجلسة خارج مسارات العمل أو الحالات الخاصة بالمفتاح. يتلقى المفتاح الذي لا يمتلك حق الوصول إلى الوسائط عناوين URL للصور ومقاطع الفيديو وملفات PDF كـ null، ويتلقى المفتاح الذي لا يمتلك إذن كتابة للجلسات روابط الجلسة وtoken كـ null. راجع https://docs.didit.me/console/api-keys.
معلمات المسار
معرّفك الفريد للمستخدم.
الجسم
حالة دورة الحياة الجديدة. يؤدي استخدام BLOCKED أيضاً إلى إضافة vendor_data إلى قائمة الحظر الخاصة بالنظام.
ACTIVE, FLAGGED, BLOCKED سبب تغيير الحالة. يُسجّل في قيد تغيير الحالة ضمن سجل نشاط المستخدم (comments[].comment، وActivity في Business Console)، فقط عندما تتغير الحالة فعلياً. لا تتضمنه أحداث webhook.
1000الاستجابة
تم تحديث حالة المستخدم. تم إرجاع سجل المستخدم الكامل.
تفاصيل المستخدم الكاملة. يوسع UserListItem بالبيانات الوصفية، والتعليقات، وحقل updated_at.
معرّف UUID الداخلي الثابت من Didit لهذا المستخدم.
معرّفك الفريد لهذا المستخدم (يتم تمريره عند إنشاء الجلسات). يمكن أن يكون هذا null في حال عدم تقديم معرّف بائع.
اسم عرض مخصص تم تعيينه بواسطتك
الاسم الكامل المستخرج من المستندات التي تم التحقق منها
أفضل اسم متاح: display_name إذا كان محدداً، وإلا فـ full_name
حالة دورة حياة سجل المستخدم (ليست حالة جلسة). القيمة الافتراضية هي ACTIVE، وFLAGGED تميز المستخدم للمراجعة اليدوية، وBLOCKED تمنع إنشاء جلسات جديدة لقيمة vendor_data هذه.
ACTIVE, FLAGGED, BLOCKED رابط موقع مسبقاً للصورة الشخصية للمستخدم (تنتهي صلاحيته بعد بضع ساعات)
العدد الإجمالي لجلسات التحقق لهذا المستخدم
عدد الجلسات المقبولة
عدد الجلسات المرفوضة
عدد الجلسات قيد المراجعة
رموز ISO 3166-1 alpha-3 لدول الإصدار الواردة في مستندات الهوية المقبولة لهذا المستخدم، مثل ["USA", "ESP"]. مصفوفة فارغة في حال عدم وجود أي منها.
عناوين البريد الإلكتروني التي تم التحقق منها والمجمعة من الجلسات المقبولة لهذا المستخدم، على سبيل المثال ["john@example.com"].
أرقام الهواتف التي تم التحقق منها والمجمعة من الجلسات المقبولة لهذا المستخدم، على سبيل المثال ["+14155551234"].
الحالة المجمعة لكل ميزة عبر جميع جلسات هذا المستخدم. المفاتيح المحتملة: ID_VERIFICATION، NFC، LIVENESS، FACE_MATCH، POA، QUESTIONNAIRE، EMAIL_VERIFICATION، PHONE، AML، IP_ANALYSIS، AGE_ESTIMATION، DATABASE_VALIDATION. القيم المحتملة: Approved، Declined، In Review، Not Finished، Resub Requested.
البيانات نفسها مثل features، كمصفوفة مرتبة من كائنات {feature, status}.
Show child attributes
Show child attributes
الطابع الزمني لأحدث جلسة
الطابع الزمني للجلسة الأولى
الطابع الزمني لأحدث نشاط لهذا المستخدم (جلسة، معاملة، تغيير حالة، تعديل بيانات، إلخ).
تعيينات العلامات. ملاحظة: في استجابات التفاصيل يكون كل إدخال كائن ربط علامة ({uuid, tag: {...}, added_by_email, added_by_name, created_at})، على عكس التنسيق المسطح {uuid, name, color} المُستخدم في استجابات القوائم.
Show child attributes
Show child attributes
بيانات وصفية مخصصة بتنسيق JSON أرفقتها بهذا المستخدم. القيمة الافتراضية هي {}.
سجل الأنشطة والتعليقات الخاصة بهذا المستخدم (تغييرات الحالة، تعديلات الملف التعريفي، الملاحظات اليدوية).
Show child attributes
Show child attributes