Video ve materyaller
Görsel Doğrulama Sonucunu Al
Görsel doğrulama tarafından üretilen gerçek kişi materyal grubunu alır.
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/jsonGö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.
| Durum | Kod | Neden |
|---|---|---|
400 | InvalidParameter | BytedToken geçersiz veya süresi dolmuş, ProjectName eşleşmiyor veya doğrulama henüz tamamlanmadı (tekrar deneyin) |
400 | InvalidVersion | Version değeri 2024-01-01 değil |
405 | MethodNotAllowed | Action sadece POST kabul eder |
409 | Conflict | Doğrulanan grup zaten başka bir organizasyonla eşleştirilmiş |
503 | ServiceUnavailable | Gerç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 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
Geçerli değerler
- "CreateContentsGenerationsTasks"
- "GetContentsGenerationsTask"
- "ListContentsGenerationsTasks"
- "DeleteContentsGenerationsTasks"
- "CreateVisualValidateSession"
- "GetVisualValidateResult"
- "CreateAssetGroup"
- "ListAssetGroups"
- "GetAssetGroup"
- "UpdateAssetGroup"
- "DeleteAssetGroup"
- "CreateAsset"
- "ListAssets"
- "GetAsset"
- "UpdateAsset"
- "DeleteAsset"
"2024-01-01"Başlıklar
İ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