Video ve materyaller

Görsel doğrulama sonucunu al

Görsel doğrulamanın oluşturduğu gerçek kişi materyal grubunu alır.

POST
/api/v3

H5 görsel doğrulama akışından sonra bu Action çağrısını tekrarlayın. Başarılı sonuç, doğrulanan kişinin TokenLab materyal grubu kimliğini döndürür.

Oturumu oluşturan aynı doğrulanmış 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 belirlediyseniz burada büyük/küçük harfe duyarlı aynı değeri gönderin; aksi halde alanı atlayın veya default kullanın.

Sonuç, tarayıcı callback işleminden hemen sonra hazır olmayabilir. Result.GroupId dönene veya 30 dakikalık BytedToken süresi dolana kadar aynı isteği tekrarlayın. Aynı token ile başarılı bir isteği tekrarlamak aynı GroupId değerini döndürür.

liveness_face materyalleri oluştururken döndürülen GroupId değerini group_id olarak kullanın.

Örnek İstek

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

Örnek Yanıt

{
  "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ı yanıt ResponseMetadata ve Result içerir; TokenLab’in diğer /v1 API yanıt yapısını kullanmaz.

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