Video & materi

Mendapatkan hasil validasi visual

Mendapatkan grup material orang asli yang dihasilkan oleh validasi visual.

POST
/api/v3

Lakukan polling Action ini setelah alur validasi visual H5. Hasil yang berhasil mengembalikan ID grup material TokenLab untuk orang yang telah diverifikasi.

Gunakan organisasi terautentikasi, pengguna, dan ProjectName peka huruf besar-kecil yang sama dengan 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/json

Kirim BytedToken yang dikembalikan oleh Membuat sesi validasi visual. Jika Anda menetapkan ProjectName saat pembuatan, kirim nilai yang sama dengan kapitalisasi yang sama di sini; jika tidak, hilangkan atau gunakan default.

Hasil mungkin belum siap segera setelah callback browser. Ulangi permintaan yang sama hingga Result.GroupId dikembalikan atau BytedToken yang berlaku 30 menit kedaluwarsa. Mengulangi permintaan yang berhasil dengan token yang sama akan mengembalikan GroupId yang sama.

Gunakan GroupId yang dikembalikan sebagai group_id saat membuat 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"
  }
}

Kesalahan menggunakan ResponseMetadata.Error.Code dan ResponseMetadata.Error.Message. Respons berhasil memuat ResponseMetadata dan Result; respons tersebut tidak menggunakan struktur respons API /v1 TokenLab lainnya.

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

Otorisasi

BearerAuth
AuthorizationBearer <token>

Autentikasi API Key. Buat atau kelola API key di Dashboard > API > API Keys.

Lokasi: header

Parameter query

Action?string

Nilai yang tersedia

  • "CreateContentsGenerationsTasks"
  • "GetContentsGenerationsTask"
  • "ListContentsGenerationsTasks"
  • "DeleteContentsGenerationsTasks"
  • "CreateVisualValidateSession"
  • "GetVisualValidateResult"
  • "CreateAssetGroup"
  • "ListAssetGroups"
  • "GetAssetGroup"
  • "UpdateAssetGroup"
  • "DeleteAssetGroup"
  • "CreateAsset"
  • "ListAssets"
  • "GetAsset"
  • "UpdateAsset"
  • "DeleteAsset"
Version?string
bawaan"2024-01-01"

Header

X-TokenLab-Delivery-Policy?string

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