Hız Limitleri

API istek limitlerini, kredi kullanımını ve hız sınırlamasını sorunsuz şekilde nasıl yöneteceğinizi öğrenin.

Mevcut limitler

İstek kotaları ve krediler ayrı kontrollerdir. API anahtarları varsayılan olarak dakikada 60 ve günde 5,000 istekle sınırlıdır. Bu kotalar, kimliği doğrulanmış bir entegrasyonun API'yi ne kadar hızlı çağırabileceğini belirler. Hesap kredileri ise kaç doğrulama yapılabileceğini belirler.

Yüksek hacimli liste çalışmalarında /api/batch tek istekte 500'e kadar e-posta kabul eder. Toplu CSV yüklemeleri istek sayısıyla değil kredilerle sınırlanır: doğrulama işinin çalışabilmesi için hesapta yüklenen dosyadaki e-posta sayısı kadar kredi bulunmalıdır.

Herkese açık anonim kontrol aracı, IP adresi başına günde 5 kontrolle sınırlıdır. Hesap bakiyesi kuralları için bkz. Krediler ve Kullanım. Büyük içe aktarımlar için şunu kullanın: Toplu Doğrulama; entegrasyon davranışı için şunu inceleyin: Hata Yönetimi, Hızlı Başlangıç ve fiyatlandırmayı,.

İstek limiti yanıtı

Bir API anahtarı istek kotasını aştığında API şunu döndürür: 429 Too Many Requests yanıtı. Yanıt şunu içerir: Retry-After ; böylece istemci yeniden denemeden önce ne kadar bekleyeceğini bilir.

{
  "error": "Too Many Requests",
  "message": "Rate limit exceeded. Please retry after the indicated delay.",
  "status_code": 429,
  "retry_after": 15
}

Retry-After başlığı

Öte yandan Retry-After yanıt başlığı, kotayı aşan bir API anahtarı isteğini yeniden denemeden önce kaç saniye beklenmesi gerektiğini belirtir:

HTTP/1.1 429 Too Many Requests
Retry-After: 15
Content-Type: application/json

Kodda istek limitlerini yönetme

Önce başlığı okuyun, belirtilen saniye kadar bekleyin ve ardından yeniden deneyin. Başlık yoksa temkinli bir varsayılan bekleme süresi kullanın.

import requests, time

def verify_with_retry(email, api_key, max_retries=3):
    for attempt in range(max_retries):
        response = requests.post(
            "https://verimails.com/api/verify/single",
            headers={"Authorization": f"Bearer {api_key}"},
            json={"email": email}
        )

        if response.status_code == 200:
            return response.json()

        if response.status_code == 429:
            retry_after = int(response.headers.get("Retry-After", 15))
            print(f"Rate limited. Waiting {retry_after}s...")
            time.sleep(retry_after)
            continue

        response.raise_for_status()

    raise Exception("Max retries exceeded")

En iyi uygulamalar

• Hesabınız için farklı limitler tanımlanmadıysa, kimliği doğrulanmış API entegrasyonlarını dakikada 60 ve günde 5,000 isteğin altında tutun.
• Gönderdiğiniz /api/batch isteklerini 500 veya daha az e-postayla sınırlı tutun.
• Bir API anahtarı isteği 429 aldığında her zaman Retry-After başlığına uyun.
• Büyük bir doğrulama işine başlamadan önce kullanılabilir kredilerinizi kontrol edin.
• CSV listeleri için Toplu Doğrulama'yı kullanın ve hesapta dosyadaki e-posta sayısı kadar kredi bulunduğundan emin olun.