الفيديو والمواد

الحصول على نتيجة التحقق المرئي

الحصول على مجموعة مواد الشخص الحقيقي الناتجة عن التحقق المرئي.

POST
/api/v3

قم باستدعاء هذا الإجراء (Action) بعد تدفق التحقق المرئي عبر H5. تُرجع النتيجة الناجحة معرف مجموعة مواد TokenLab للشخص الذي تم التحقق منه.

استخدم نفس المؤسسة والمستخدم و ProjectName (مع مراعاة حالة الأحرف) التي تم استخدامها لإنشاء الجلسة.

نقطة النهاية والمصادقة

POST https://api.tokenlab.sh/api/v3?Action=GetVisualValidateResult&Version=2024-01-01
Authorization: Bearer <TOKENLAB_API_KEY>
Content-Type: application/json

أرسل BytedToken الذي تم إرجاعه بواسطة إنشاء جلسة تحقق مرئي. إذا قمت بتعيين ProjectName أثناء الإنشاء، فأرسل نفس القيمة مع مراعاة حالة الأحرف هنا؛ وإلا فتجاهلها أو استخدم default.

قد لا تكون النتيجة جاهزة مباشرة بعد رد الاتصال (callback) الخاص بالمتصفح. أعد محاولة إرسال نفس الطلب حتى يتم إرجاع Result.GroupId أو حتى تنتهي صلاحية BytedToken البالغة 30 دقيقة. تكرار طلب ناجح بنفس الرمز يُرجع نفس GroupId المعين.

استخدم GroupId المُرجع كـ group_id عند إنشاء أصول مواد liveness_face.

مثال على الطلب

curl 'https://api.tokenlab.sh/api/v3?Action=GetVisualValidateResult&Version=2024-01-01' \
  -H "Authorization: Bearer $TOKENLAB_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"BytedToken":"ZXhhbXBsZS10b2tlbg","ProjectName":"default"}'

مثال على الاستجابة

{
  "ResponseMetadata": {
    "RequestId": "req_def456",
    "Action": "GetVisualValidateResult",
    "Version": "2024-01-01",
    "Service": "ark",
    "Region": "cn-beijing"
  },
  "Result": {
    "GroupId": "group-20260720123456-real1"
  }
}

تستخدم الأخطاء ResponseMetadata.Error.Code و ResponseMetadata.Error.Message. تحتوي استجابة النجاح على ResponseMetadata و Result؛ وهي لا تستخدم غلاف الاستجابة الخاص بواجهات برمجة تطبيقات TokenLab الأخرى من الإصدار /v1.

الحالةالرمزالسبب
400InvalidParameterBytedToken غير صالح أو منتهي الصلاحية، أو أن ProjectName غير متطابق، أو أن التحقق لم يكتمل بعد (أعد المحاولة)
400InvalidVersionVersion ليس 2024-01-01
405MethodNotAllowedالإجراء يقبل فقط POST
409Conflictالمجموعة التي تم التحقق منها مرتبطة بالفعل بمؤسسة أخرى
503ServiceUnavailableالتحقق من الشخص الحقيقي غير متاح أو فشل الطلب؛ أعد المحاولة لاحقاً
curl -X POST "https://example.com/api/v3" \  -H "Content-Type: application/json" \  -d '{    "CallbackURL": "http://example.com"  }'
{  "id": "string"}

التفويض

BearerAuth
AuthorizationBearer <token>

مصادقة مفتاح API. قم بإنشاء أو إدارة مفاتيح API في Dashboard > API > API Keys.

الموضع: header

معاملات الاستعلام

Action?string

القيم المتاحة

  • "CreateContentsGenerationsTasks"
  • "GetContentsGenerationsTask"
  • "ListContentsGenerationsTasks"
  • "DeleteContentsGenerationsTasks"
  • "CreateVisualValidateSession"
  • "GetVisualValidateResult"
  • "CreateAssetGroup"
  • "ListAssetGroups"
  • "GetAssetGroup"
  • "UpdateAssetGroup"
  • "DeleteAssetGroup"
  • "CreateAsset"
  • "ListAssets"
  • "GetAsset"
  • "UpdateAsset"
  • "DeleteAsset"
Version?string
الافتراضي"2024-01-01"

الترويسات

X-TokenLab-Delivery-Policy?string

سياسة التسليم لكل طلب. تتجاوز إعدادات API key و Workspace الافتراضية. يحاول النظام تلقائياً استخدام TokenLab Verified أولاً، وقد ينتقل مرة واحدة إلى Official فقط قبل المخرجات، أو قبول الطلب، أو إنشاء مورد دائم.

القيم المتاحة

  • "auto"
  • "verified"
  • "official"

جسم الطلب

application/json

الاستجابة

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json