الفيديو والمواد
الحصول على نتيجة التحقق المرئي
الحصول على مجموعة مواد الشخص الحقيقي الناتجة عن التحقق المرئي.
قم باستدعاء هذا الإجراء (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.
| الحالة | الرمز | السبب |
|---|---|---|
400 | InvalidParameter | BytedToken غير صالح أو منتهي الصلاحية، أو أن ProjectName غير متطابق، أو أن التحقق لم يكتمل بعد (أعد المحاولة) |
400 | InvalidVersion | Version ليس 2024-01-01 |
405 | MethodNotAllowed | الإجراء يقبل فقط POST |
409 | Conflict | المجموعة التي تم التحقق منها مرتبطة بالفعل بمؤسسة أخرى |
503 | ServiceUnavailable | التحقق من الشخص الحقيقي غير متاح أو فشل الطلب؛ أعد المحاولة لاحقاً |
curl -X POST "https://example.com/api/v3" \ -H "Content-Type: application/json" \ -d '{ "CallbackURL": "http://example.com" }'{ "id": "string"}التفويض
BearerAuth مصادقة مفتاح API. قم بإنشاء أو إدارة مفاتيح API في Dashboard > API > API Keys.
الموضع: header
معاملات الاستعلام
القيم المتاحة
- "CreateContentsGenerationsTasks"
- "GetContentsGenerationsTask"
- "ListContentsGenerationsTasks"
- "DeleteContentsGenerationsTasks"
- "CreateVisualValidateSession"
- "GetVisualValidateResult"
- "CreateAssetGroup"
- "ListAssetGroups"
- "GetAssetGroup"
- "UpdateAssetGroup"
- "DeleteAssetGroup"
- "CreateAsset"
- "ListAssets"
- "GetAsset"
- "UpdateAsset"
- "DeleteAsset"
"2024-01-01"الترويسات
سياسة التسليم لكل طلب. تتجاوز إعدادات 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