> ## Documentation Index
> Fetch the complete documentation index at: https://docs.tokenlab.sh/llms.txt
> Use this file to discover all available pages before exploring further.

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

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

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

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

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

أرسل `BytedToken` التي أعادها [إنشاء جلسة تحقق مرئي](/ar/api-reference/video/create-visual-validation-session). إذا عيّنت `ProjectName` عند الإنشاء، فأرسل القيمة نفسها هنا مع مراعاة حالة الأحرف؛ وإلا فاتركها أو استخدم `default`.

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

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

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

```bash theme={null}
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"}'
```

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

```json theme={null}
{
  "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`.