Görsel doğrulama oturumu oluştur

Yeniden kullanılabilir liveness_face materyallerini yüklemeden önce bir görsel doğrulama oturumu oluşturun. TokenLab, Volc Action API biçimini ve TokenLab Bearer kimlik doğrulamasını kullanır.

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

Oturumu oluşturduktan hemen sonra Result.H5Link bağlantısını açın. H5 ilk açılış süresi, 30 dakika geçerli BytedToken süresinden önce dolabilir.

Uç nokta ve kimlik doğrulamaCopy Anchor Link

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

Volc AK/SK imzaları kabul edilmez. CallbackURL zorunludur ve herkese açık bir HTTPS URL’si olmalıdır. ProjectName isteğe bağlıdır ve varsayılan değeri default şeklindedir.

AkışCopy Anchor Link

1. Result.BytedToken değerini kaydedin ve doğrulanacak kişi için Result.H5Link bağlantısını açın.
2. H5 dilini seçmek için H5Link bağlantısına lng ekleyin; örneğin &lng=en. Dil, istek gövdesi alanı değildir.
3. H5 akışı tamamlandığında tarayıcı Result.CallbackURL adresini açar. Callback sorgusu bytedToken, resultCode, algorithmBaseRespCode, reqMeasureInfoValue ve verify_type içerebilir.
4. Result.GroupId dönene kadar kaydedilen BytedToken ile Görsel doğrulama sonucunu al çağrısını tekrarlayın.

BytedToken 30 dakika geçerlidir ve kimliği doğrulanmış kuruluş ile ProjectName değerine bağlıdır. H5 bağlantısı tamamlanmış tek bir doğrulamayı destekler ve kullanımdan sonra geçersiz olur.

Result.H5Link değerini opak bir tarayıcı URL'si olarak ele alın: üst düzey sayfa olarak açın; ayrıştırmayın, kodunu çözmeyin, yeniden yazmayın veya gömmeyin. Tarayıcı aktarımını ve callback köprüsünü TokenLab yönetir.

Örnek İstekCopy Anchor Link

curl 'https://api.tokenlab.sh/api/v3?Action=CreateVisualValidateSession&Version=2024-01-01' \
  -H "Authorization: Bearer $TOKENLAB_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"CallbackURL":"https://yourapp.example.com/seedance/callback","ProjectName":"default"}'

Örnek YanıtCopy Anchor Link

{
  "ResponseMetadata": {
    "RequestId": "req_abc123",
    "Action": "CreateVisualValidateSession",
    "Version": "2024-01-01",
    "Service": "ark",
    "Region": "cn-beijing"
  },
  "Result": {
    "BytedToken": "ZXhhbXBsZS10b2tlbg",
    "H5Link": "https://api.tokenlab.sh/api/v3/visual-validation/sessions/svv_example/h5?Version=2024-01-01",
    "CallbackURL": "https://yourapp.example.com/seedance/callback"
  }
}

Hatalar aynı üst düzey yapıyı kullanır. TokenLab’in diğer /v1 API hata alanları yerine ResponseMetadata.Error.Code ve ResponseMetadata.Error.Message değerlerini okuyun.

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

{  "id": "string"}