Video & materi
Mendapatkan Hasil Validasi Visual
Mendapatkan grup material orang asli yang dihasilkan oleh validasi visual.
Lakukan polling pada Action ini setelah alur validasi visual H5. Hasil yang sukses akan mengembalikan ID grup material TokenLab untuk orang yang diverifikasi.
Gunakan organisasi, pengguna, dan ProjectName peka huruf besar-kecil (case-sensitive) yang sama dengan yang digunakan saat membuat sesi.
Endpoint Dan Autentikasi
POST https://api.tokenlab.sh/api/v3?Action=GetVisualValidateResult&Version=2024-01-01
Authorization: Bearer <TOKENLAB_API_KEY>
Content-Type: application/jsonKirim BytedToken yang dikembalikan oleh Membuat Sesi Validasi Visual. Jika Anda menetapkan ProjectName selama pembuatan, kirim nilai peka huruf besar-kecil yang sama di sini; jika tidak, abaikan atau gunakan default.
Hasil mungkin tidak langsung tersedia setelah callback browser. Coba ulangi permintaan yang sama hingga Result.GroupId dikembalikan atau BytedToken selama 30 menit kedaluwarsa. Mengulangi permintaan yang sukses dengan token yang sama akan mengembalikan GroupId yang dipetakan sama.
Gunakan GroupId yang dikembalikan sebagai group_id saat membuat aset material liveness_face.
Contoh Permintaan
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"}'Contoh Respons
{
"ResponseMetadata": {
"RequestId": "req_def456",
"Action": "GetVisualValidateResult",
"Version": "2024-01-01",
"Service": "ark",
"Region": "cn-beijing"
},
"Result": {
"GroupId": "group-20260720123456-real1"
}
}Error menggunakan ResponseMetadata.Error.Code dan ResponseMetadata.Error.Message. Respons sukses berisi ResponseMetadata dan Result; ini tidak menggunakan amplop respons dari API /v1 TokenLab lainnya.
| Status | Kode | Penyebab |
|---|---|---|
400 | InvalidParameter | BytedToken tidak valid atau kedaluwarsa, ProjectName tidak cocok, atau verifikasi belum selesai (coba lagi) |
400 | InvalidVersion | Version bukan 2024-01-01 |
405 | MethodNotAllowed | Action ini hanya menerima POST |
409 | Conflict | Grup yang diverifikasi sudah dipetakan ke organisasi lain |
503 | ServiceUnavailable | Validasi orang asli tidak tersedia atau permintaan gagal; coba lagi nanti |
curl -X POST "https://example.com/api/v3" \ -H "Content-Type: application/json" \ -d '{ "CallbackURL": "http://example.com" }'{ "id": "string"}Otorisasi
BearerAuth Autentikasi API Key. Buat atau kelola API key di Dashboard > API > API Keys.
Lokasi: header
Parameter query
Nilai yang tersedia
- "CreateContentsGenerationsTasks"
- "GetContentsGenerationsTask"
- "ListContentsGenerationsTasks"
- "DeleteContentsGenerationsTasks"
- "CreateVisualValidateSession"
- "GetVisualValidateResult"
- "CreateAssetGroup"
- "ListAssetGroups"
- "GetAssetGroup"
- "UpdateAssetGroup"
- "DeleteAssetGroup"
- "CreateAsset"
- "ListAssets"
- "GetAsset"
- "UpdateAsset"
- "DeleteAsset"
"2024-01-01"Header
Kebijakan Pengiriman per-permintaan. Menggantikan default API key dan Workspace. Secara otomatis mencoba TokenLab Verified terlebih dahulu dan dapat beralih satu kali ke Official saja sebelum output, penerimaan permintaan, atau pembuatan sumber daya persisten.
Nilai yang tersedia
- "auto"
- "verified"
- "official"
Body permintaan
application/json
Respons
application/json
application/json
application/json
application/json
application/json
application/json
application/json
application/json
application/json
application/json