Video & materi

Mendapatkan Hasil Validasi Visual

Mendapatkan grup material orang asli yang dihasilkan oleh validasi visual.

POST
/api/v3

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/json

Kirim 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.

StatusKodePenyebab
400InvalidParameterBytedToken tidak valid atau kedaluwarsa, ProjectName tidak cocok, atau verifikasi belum selesai (coba lagi)
400InvalidVersionVersion bukan 2024-01-01
405MethodNotAllowedAction ini hanya menerima POST
409ConflictGrup yang diverifikasi sudah dipetakan ke organisasi lain
503ServiceUnavailableValidasi 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
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