Domain Name API Hız Sınırı, Throttling & Toplu Kullanım Politikası

Domain Name API, bayi entegrasyon süreçlerini geniş ölçekte optimize etmek için tasarlanmış, kurumsal düzeyde yüksek erişilebilirlikli bir API altyapısı sunmaktadır. Tüm ortaklar için adil, dengeli ve sürdürülebilir API erişimi sağlamak amacıyla kullanım; ayrı endpoint’ler, hız sınırları ve API throttling kontrolleriyle iki kategoriye ayrılmıştır.

Hızlı Kural Özeti

Tüm hız sınırı, API throttling ve endpoint kuralları için hızlı başvuru tablosu.

1. Tanımlar: Hız Sınırlama ve API Throttling

2. Standart ve Toplu API Kullanımı Nedir?

Saniyede 1’den fazla otomatik istek içeren her senaryo toplu kullanım olarak sınıflandırılır ve yalnızca /api-bulk kullanılmalıdır. Bu; async model, thread sayısı veya eşzamanlılık stratejisinden bağımsız olarak geçerlidir.

Örnekler

• Domain uygunluk tarama scriptleri
• Backorder ve dro-catching sistemleri
• Toplu domain kontrol / kayıt iş akışları
• Cron job ve arka plan worker servisleri
• Webhook retry ve olay tabanlı otomasyon

3. Toplu API Endpoint Kuralları (/api-bulk)

Tüm otomatik ve toplu işlemler ayrılmış endpoint üzerinden yürütülmelidir. Her iki endpoint de aynı işlevselliği sunar; tek fark kullanılan temel URI’dir.

Toplu trafik için /api’nin yanlış kullanımında herhangi bir performans, hız veya öncelik avantajı YOKTUR. Sistem bunu imkânsız kılacak şekilde tasarlanmıştır.

4. API Hız Sınırları ve Throttling Açıklandı

Eşzamanlılık Kuralı

Sisteminiz çok thread’li veya tamamen asenkron olsa bile toplam gönderilen istek hızı API Anahtarı başına saniyede 1 isteği geçemez.

• Paralel async çağrılar aynı hız sınırına dahil sayılır
• Çok thread’li yapı daha yüksek bir kota hakkı sağlamaz
• Tüm thread ve worker’larda ortak merkezi bir hız sınırlayıcı veya kuyruk kullanın

5. HTTP 429 Hataları Nasıl Düzeltilir (Hız Sınırı Aşımı Çözümü)

Entegrasyonunuz HTTP 429 Çok Fazla İstek alıyorsa aşağıdaki adımları izleyin:

1. İstekleri hemen durdurun
2. 429 yanıtından Retry-After header değerini okuyun
3. En az 1 saniye (veya Retry-After değeri, hangisi büyükse) bekleyin
4. Başarısız isteği yeniden deneyin
5. 429 sürüyorsa -> üstel backoff uygulayın: 1sn -> 2sn -> 4sn -> 8sn -> ...
6. Tüm otomatik çağrılar için /api-bulk kullandığınızı doğrulayın
7. Tüm thread’lerde toplam eşzamanlılığın 1 istek/sn’yi geçmediğini kontrol edin

6. Kod Örnekleri (Toplu API En İyi Uygulamaları)

Aşağıdaki örnekler en yaygın entegrasyon dillerinde doğru hız sınırı yönetimi ve üstel backoff uygulanmasını göstermektedir.

C# (.NET / Windows entegrasyonları)

// C# — Retry-After destekli Üstel Backoff
var delay = 1000; // 1 saniyeden başla
var maxDelay = 60000; // 60 saniyede sınırla

while (true)
{
    var response = await client.SendAsync(request);

    if ((int)response.StatusCode == 429)
    {
        var retryAfter = response.Headers.RetryAfter?.Delta?.TotalMilliseconds ?? delay;
        await Task.Delay((int)Math.Max(retryAfter, delay));
        delay = Math.Min(delay * 2, maxDelay); // ustel backoff
        continue;
    }

    break; // basarili -- donguden cik
}

PHP (WordPress / cPanel entegrasyonları)

// PHP — Retry-After destekli Üstel Backoff
function sendWithRetry($url, $headers, $maxRetries = 5) {
    $delay = 1; // saniye
    for ($i = 0; $i < $maxRetries; $i++) {
        $response = httpRequest($url, $headers);
        if ($response['status'] === 429) {
            $retryAfter = $response['headers']['Retry-After'] ?? $delay;
            sleep(max((int)$retryAfter, $delay));
            $delay = min($delay * 2, 60); // 60 saniyede sinirla
            continue;
        }
        return $response; // basarili
    }
    throw new Exception('Maksimum deneme sayisi asildi');
}

Python (script / otomasyon)

# Python — Retry-After destekli Üstel Backoff
import time, requests

def send_with_retry(url, headers, max_retries=5):
    delay = 1  # saniye
    for attempt in range(max_retries):
        response = requests.get(url, headers=headers)
        if response.status_code == 429:
            retry_after = int(response.headers.get('Retry-After', delay))
            time.sleep(max(retry_after, delay))
            delay = min(delay * 2, 60)  # ustel backoff, 60sn sinir
            continue
        return response  # basarili
    raise Exception('Maksimum deneme sayisi asildi')

7. İstek Akış Diyagramı

Her toplu API isteği bu akışı izlemelidir. Entegrasyon ekibiniz için referans olarak kaydedin.

              TOPLU API İSTEK AKISI

  +---------------------+
  |  Domain'i istek     |
  |  kuyruğuna ekle     |
  +----------+----------+
             |
             v
  +---------------------+
  |  /api-bulk'a istek  |
  |  gönder             |
  +----------+----------+
             |
       +-----+------+
       |            |
     200 OK     429 Çok Fazla İstek
       |            |
       v            v
    Sonucu      Retry-After header oku
    iŞle        En az 1 saniye bekle
       |            |
       |            v
       |        Üstel backoff uygula
       |        1sn -> 2sn -> 4sn -> 8sn
       |            |
       |            v
       |        İsteği yeniden dene
       |            |
       +-----+------+
             |
             v
  +---------------------+
  |  Kuyruktaki sonraki |
  |  öğe                |
  +---------------------+

8. Toplu API Entegrasyonu İçin En İyi Uygulamalar

9. Kaçınılması Gereken Yaygın Entegrasyon Hataları

10. SSS — Sıkça Sorulan Sorular

API hız sınırlama, throttling ve toplu API kullanımı hakkındaki yaygın sorular.

11. Otomatik İzleme ve Kötüye Kullanım Tespiti

Aşağıdaki davranışlar tüm API trafikğinde sürekli izlenmektedir:

• Ölçülebilir sistem performansı düşüşüne neden olan yüksek hacimli trafik
• Aynı domain için tekrarlayan kayıt veya sorgulama denemeleri
• Yüksek hata-başarı oranı (fail rate)
• Anormal veya şüpheli trafik örüntüleri
• Bağlantı kararsızlığı ve zaman aşımı anomalileri

12. Bu Politika Neden Var?

Bu politika şunları sağlamak için oluşturulmuştur:

13. Daha Yüksek Hız Sınırı Talep Etme