Hesap

Birden fazla ClientKey: limit, IP izin listesi ve son kullanma

Bu sayfa Çince sürümden makine çevirisiyle hazırlanmıştır ve hatalar içerebilir. Geçerli olan Çince sürüm sürümüdür.

Bir YesCaptcha hesabında (mevcut olan dahil) en fazla 20 clientKey olabilir. Bunlar yescaptcha.com panelindeki “Anahtarlar ve güvenlik” sayfasından yönetilir. Her clientKey görev oluşturabilir ve bakiye sorgulayabilir; hepsi aynı hesap bakiyesinden düşer. Her biri için ayrı harcama limiti, IP izin listesi ve son kullanma tarihi belirlenebilir; değişiklikler birkaç saniye içinde geçerli olur.

Şu durumlarda işe yarar: test ve üretim ortamlarını ya da farklı projeleri ayırmak; alt müşterilere veya iş ortaklarına, her birine ayrı limitle anahtar vermek; bir clientKey sızarsa yalnızca onu silmek, diğer programları etkilememek.

Ana Key ve alt Key’ler

	Ana Key	Alt Key
Hangisi	Mevcut `clientKey`; hesap başına bir tane	Ana Key’in dışında oluşturulanlar; en fazla 19
Limit, IP izin listesi, son kullanma	Ayarlanabilir	Ayarlanabilir
Sıfırlama	Evet: eskisi hemen geçersiz olur, bakiye yenisine geçer	Hayır; silip yeniden oluşturun
Silme	Hayır	Evet: birkaç saniye içinde geçersiz olur, geri alınamaz

Hepsinin biçimi aynıdır: ilk 40 karakter anahtardır, ardından kullanıcı ID’niz gelir.
Ana Key’i sıfırlamak alt Key’leri etkilemez.
Görev oluşturmak ve bakiye sorgulamak için hangi clientKey’i kullanırsanız kullanın, API ve yanıtlar aynıdır; yalnızca limit, IP izin listesi ve son kullanma kontrolleri eklenir.

Yeni clientKey oluşturma

yescaptcha.com adresinde giriş yapın ve “Anahtarlar ve güvenlik” sayfasını açın (yescaptcha.com/security).
“Tüm Key’ler” bölümünde “Yeni alt Key”e tıklayın. Ad (en fazla 40 karakter), Limit, IP izin listesi ve Son kullanma alanlarını boş bırakabilirsiniz; sonradan da değiştirilebilir.
İstendiğinde kimliğinizi bir kez daha doğrulayın. Oluşturma, değiştirme ve silme işlemlerinin hepsinde doğrulama gerekir.
Oluşturduktan sonra tam clientKey değerini kopyalayıp programınıza ekleyin. Sonradan listedeki göz simgesine tıklayarak da görebilirsiniz.

Harcama limiti

Limit, bir clientKey’in bir dönemde en fazla kaç puan harcayabileceğini belirler (1,000 puan = ¥1). 1 ile 10,000,000,000 puan arasında ayarlanabilir. Dönem dört türlüdür ve Pekin saatine (UTC+8) göre sıfırlanır:

Dönem	Ne zaman sıfırlanır
Günlük	Her gün saat 00:00
Haftalık	Her Pazartesi saat 00:00
Aylık	Her ayın 1’i saat 00:00
Tek seferlik toplam	Sıfırlanmaz. Tükendiğinde bu `clientKey` artık görev oluşturamaz; kullanmaya devam etmek için limiti yükseltin

Fiilen düşülen puan hesaplanır: tanıma başarısız olduğunda veya zaman aşımında iade edilen puanlar limite de geri eklenir.
Mevcut dönemde kalan limit görevin puan düşümüne yetmezse createTask ERROR_KEY_QUOTA_EXCEEDED döndürür; puan düşülmez ve otomatik duraklatma sayılmaz.
Paneldeki listede her clientKey’in mevcut dönemde ne kadar kullandığı ve bir sonraki sıfırlanma zamanı görünür.
Limit ayrı bir bakiye değildir: tüm clientKey’ler aynı hesap bakiyesinden düşer; hesap bakiyesi yetmezse her zamanki gibi ERROR_ZERO_BALANCE döner.

Limit ayarlanmış bir clientKey ile getBalance çağırdığınızda balance, hesap bakiyesi ile mevcut dönemde kalan limitten küçük olanıdır; ayrıca keyQuotaRemaining alanı (kalan limit, puan cinsinden) eklenir. Limit ayarlanmamış clientKey için bu alan gelmez, yanıt eskisi gibidir.

{
  "errorId": 0,
  "balance": 20000,
  "softBalance": 0,
  "inviteBalance": 0,
  "inviteBy": 0,
  "keyQuotaRemaining": 20000
}

IP izin listesi

IP izin listesi ayarlanmış bir clientKey, yalnızca listedeki IP’lerden gelen isteklerde çalışır. Boş bırakırsanız kısıtlama olmaz.

YesCaptcha API’sini çağıran makinenin genel IP’sini (çıkış IP’si) girin; görev parametrelerindeki proxy’yi değil. Birden fazla makineden çağrı yapıyorsanız her birinin genel IP’sini ekleyin.
Her satıra bir IPv4 veya IPv6 adresi ya da CIDR aralığı yazın; en fazla 50 kayıt. Tek bir adres yalnızca o IP’ye izin verir.
Aralıklar ağ adresi olarak yazılmalıdır: 203.0.113.0/24 kabul edilir, 203.0.113.5/24 edilmez (host bitleri sıfır değil).

203.0.113.10
198.51.100.0/24
2001:db8::/32

İstek IP’si listede değilse createTask ve getBalance ERROR_KEY_IP_NOT_ALLOWED döndürür; puan düşülmez ve otomatik duraklatma sayılmaz.
Çıkış IP’si değişenlerde (ev interneti, bulut fonksiyonları, dönen çıkışlar) izin listesi ayarlamayın veya tüm aralığı ekleyin.

Son kullanma

Herhangi bir clientKey (Ana Key dahil) için on yıl içinde bir son kullanma tarihi belirlenebilir; sonradan istediğiniz zaman değiştirilebilir veya kaldırılabilir.
Süresi dolduktan sonra bu anahtarla yapılan createTask ve getBalance çağrıları ERROR_KEY_EXPIRED döndürür; puan düşülmez. Daha önce oluşturulmuş görevlerin sonucu getTaskResult ile yine alınabilir.
Uzun süre kullanılmayan clientKey’lere sistem, hesap güvenliği için bir son kullanma tarihi koyar ve süre dolmadan önce e-posta ile hatırlatır. Bu son kullanma tarihi değiştirilemez: Ana Key’i yeniden oluşturun (bakiye otomatik olarak yenisine geçer) veya yeni bir clientKey oluşturun, ardından programınızı güncelleyin.

Bakiye, eşzamanlı görev sınırı ve otomatik duraklatma

Bakiye: tüm clientKey’ler aynı hesap bakiyesinden düşer. Bakiye yükleme, VIP bonusu, davet ödülü ve geliştirici gelir payı hesap bazında işler; hangi clientKey’i kullandığınızdan bağımsızdır.
Eşzamanlı görev sınırı: hesap bazında hesaplanır; tüm clientKey’ler aynı üst sınırı paylaşır. Bkz. Eşzamanlı görev sınırı ve otomatik duraklatma.
Otomatik duraklatma: her clientKey için ayrı hesaplanır; bir clientKey çok fazla hata nedeniyle duraklatılırsa diğerleri etkilenmez.

İlgili hata kodları

Hata kodu	Ne zaman döner
`ERROR_KEY_QUOTA_EXCEEDED`	Mevcut dönemde kalan limit bu görevin puan düşümüne yetmiyor (`createTask`)
`ERROR_KEY_IP_NOT_ALLOWED`	İstek IP’si bu `clientKey`’in IP izin listesinde değil (`createTask`, `getBalance`)
`ERROR_KEY_EXPIRED`	`clientKey`’in süresi dolmuş (`createTask`, `getBalance`)

Bunların hiçbirinde puan düşülmez. Yapılacaklar için bkz. Hata kodları.