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

> Bir YesCaptcha hesabında en fazla 20 ClientKey olabilir ve hepsi aynı hesap bakiyesinden düşer. Her biri için ayrı harcama limiti (günlük, haftalık, aylık veya tek seferlik; Pekin saatine göre sıfırlanır), IP izin listesi ve son kullanma tarihi belirlenebilir; değişiklikler birkaç saniye içinde geçerli olur.

Source: https://docs.yescaptcha.com/tr/account/client-keys/ · Last verified: 2026-10-29

> This page was machine-translated from the Chinese version. If anything differs, the Chinese version prevails: https://docs.yescaptcha.com/zh/account/client-keys/

Bir YesCaptcha hesabında (mevcut olan dahil) en fazla 20 `clientKey` olabilir. Bunlar [yescaptcha.com](https://yescaptcha.com/security) 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

1.  [yescaptcha.com](https://yescaptcha.com/) adresinde giriş yapın ve “Anahtarlar ve güvenlik” sayfasını açın ([yescaptcha.com/security](https://yescaptcha.com/security)).
2.  “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.
3.  İstendiğinde kimliğinizi bir kez daha doğrulayın. Oluşturma, değiştirme ve silme işlemlerinin hepsinde doğrulama gerekir.
4.  Oluşturduktan sonra tam `clientKey` değerini kopyalayıp programınıza ekleyin. Sonradan listedeki göz simgesine tıklayarak da görebilirsiniz.

> **Not:** Oluşturma, değiştirme ve silme birkaç saniye içinde geçerli olur. Oluşturduktan hemen sonra yapılan çağrı `ERROR_KEY_DOES_NOT_EXIST` döndürebilir; birkaç saniye bekleyip yeniden deneyin. Silme veya ayarları sıkılaştırma sonrasındaki birkaç saniye içinde, halihazırda gönderilmiş istekler eski ayarlara göre işlenebilir.

## 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`](https://docs.yescaptcha.com/tr/api/errors.md#ERROR_KEY_QUOTA_EXCEEDED) döndürür; puan düşülmez ve [otomatik duraklatma](https://docs.yescaptcha.com/tr/api/rate-limits.md) 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`](https://docs.yescaptcha.com/tr/api/get-balance.md) ç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.

```json
{
  "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).

```text
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`](https://docs.yescaptcha.com/tr/api/errors.md#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`](https://docs.yescaptcha.com/tr/api/errors.md#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](https://docs.yescaptcha.com/tr/api/rate-limits.md).
-   **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`](https://docs.yescaptcha.com/tr/api/errors.md#ERROR_KEY_QUOTA_EXCEEDED) | Mevcut dönemde kalan limit bu görevin puan düşümüne yetmiyor (`createTask`) |
| [`ERROR_KEY_IP_NOT_ALLOWED`](https://docs.yescaptcha.com/tr/api/errors.md#ERROR_KEY_IP_NOT_ALLOWED) | İstek IP’si bu `clientKey`’in IP izin listesinde değil (`createTask`, `getBalance`) |
| [`ERROR_KEY_EXPIRED`](https://docs.yescaptcha.com/tr/api/errors.md#ERROR_KEY_EXPIRED) | `clientKey`’in süresi dolmuş (`createTask`, `getBalance`) |

Bunların hiçbirinde puan düşülmez. Yapılacaklar için bkz. [Hata kodları](https://docs.yescaptcha.com/tr/api/errors.md).