Video ve materyaller

Görsel Doğrulama Sonucunu Al

Görsel doğrulama tarafından üretilen gerçek kişi materyal grubunu alır.

POST
/api/v3

H5 görsel doğrulama akışından sonra bu Action'ı sorgulayın (poll). Başarılı bir sonuç, doğrulanan kişi için TokenLab materyal grubu kimliğini (ID) döndürür.

Oturumu oluşturan aynı kimlik doğrulamalı organizasyonu, kullanıcıyı ve büyük/küçük harfe duyarlı ProjectName değerini kullanın.

Uç Nokta ve Kimlik Doğrulama

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

Görsel Doğrulama Oturumu Oluştur tarafından döndürülen BytedToken değerini gönderin. Oluşturma sırasında ProjectName ayarladıysanız, burada aynı büyük/küçük harfe duyarlı değeri gönderin; aksi takdirde bu alanı boş bırakın veya default değerini kullanın.

Sonuç, tarayıcı geri çağırmasından (callback) hemen sonra hazır olmayabilir. Result.GroupId dönene veya 30 dakikalık BytedToken süresi dolana kadar aynı isteği tekrar deneyin. Başarılı bir isteği aynı token ile tekrarlamak, aynı eşleştirilmiş GroupId değerini döndürür.

Döndürülen GroupId değerini, liveness_face materyal varlıklarını oluştururken group_id olarak kullanın.

İstek Örneği

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

Yanıt Örneği

{
  "ResponseMetadata": {
    "RequestId": "req_def456",
    "Action": "GetVisualValidateResult",
    "Version": "2024-01-01",
    "Service": "ark",
    "Region": "cn-beijing"
  },
  "Result": {
    "GroupId": "group-20260720123456-real1"
  }
}

Hatalar ResponseMetadata.Error.Code ve ResponseMetadata.Error.Message kullanır. Başarılı bir yanıt ResponseMetadata ve Result içerir; TokenLab'in diğer /v1 API'lerindeki yanıt zarfını kullanmaz.

DurumKodNeden
400InvalidParameterBytedToken geçersiz veya süresi dolmuş, ProjectName eşleşmiyor veya doğrulama henüz tamamlanmadı (tekrar deneyin)
400InvalidVersionVersion değeri 2024-01-01 değil
405MethodNotAllowedAction sadece POST kabul eder
409ConflictDoğrulanan grup zaten başka bir organizasyonla eşleştirilmiş
503ServiceUnavailableGerçek kişi doğrulaması kullanılamıyor veya istek başarısız oldu; daha sonra tekrar deneyin
curl -X POST "https://example.com/api/v3" \  -H "Content-Type: application/json" \  -d '{    "CallbackURL": "http://example.com"  }'
{  "id": "string"}

Yetkilendirme

BearerAuth
AuthorizationBearer <token>

API Anahtarı kimlik doğrulaması. API anahtarlarını Dashboard > API > API Keys bölümünden oluşturun veya yönetin.

Konum: header

Sorgu parametreleri

Action?string

Geçerli değerler

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

Başlıklar

X-TokenLab-Delivery-Policy?string

İstek bazlı Teslimat politikası. API anahtarı ve Çalışma Alanı varsayılanlarını geçersiz kılar. Otomatik olarak önce TokenLab Verified dener ve çıktı, istek kabulü veya kalıcı kaynak oluşturma öncesinde bir kez Official seçeneğine geçiş yapabilir.

Geçerli değerler

  • "auto"
  • "verified"
  • "official"

İstek gövdesi

application/json

Yanıt

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json