İçeriğe geç
Geliştirici

Hız sınırları

NeSınır
REST APIAnahtar başına saatte 600 istek
MCPREST ile ortak sayaç
Sayfa başına kayıtUca göre en çok 200–1000 (adet)
Yaptırım taramasıİstek başına en çok 500 ad
Hızlı sorgu (/api/v1/ara/)Ayrıca anahtar başına saatte 300 sorgu
WebhookEn çok 5 adres

Sınır aşılınca 429 hiz_siniri döner. Retry-After başlığı ve hata_ayrinti.tekrar_sn pencerenin sıfırlanmasına kalan saniyeyi verir; o kadar bekleyip yeniden deneyin.

Python
import time

import requests


def ulawk_get(adres, basliklar, deneme=5):
    for _ in range(deneme):
        r = requests.get(adres, headers=basliklar, timeout=30)
        ayrinti = (r.json().get("hata_ayrinti") or {}) if r.headers.get("Content-Type", "").startswith("application/json") else {}
        if r.ok or not ayrinti.get("tekrar_denenebilir"):
            return r
        time.sleep(int(r.headers.get("Retry-After") or ayrinti.get("tekrar_sn") or 60))
    return r

İyi uygulama

  • Günlük değişiklikleri tek istekle alın: GET /api/v1/degisiklikler/?gun=1 ya da webhook kullanın; her şirketi tek tek sorgulamayın.
  • Herkese açık /api/katalog/ ve /durum.json önbelleklidir (Cache-Control); sık sorgulamaya gerek yok.
  • Daha yüksek sınır gerekiyorsa [email protected] adresine yazın.

Markdown · OpenAPI · llms.txt · © 2026 Ulawk