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

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

استخدم المؤسسة المصادق عليها والمستخدم وProjectName نفسها التي أنشأت الجلسة، مع مراعاة حالة الأحرف.

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

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 دقيقة. يؤدي تكرار طلب ناجح باستخدام token نفسها إلى إعادة GroupId نفسها.

استخدم GroupId المُعادة بوصفها group_id عند إنشاء مواد liveness_face.

مثال على الطلبCopy Anchor Link

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"}'

مثال على الاستجابةCopy Anchor Link

{
  "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.

curl -X POST "https://example.com/api/v3" \  -H "Content-Type: application/json" \  -d '{    "CallbackURL": "http://example.com"  }'

{  "id": "string"}