İstek sınırları

Her hesap, REST POST /api/v1/links, POST /api/v1/uploads, POST /api/v1/sheets ve MCP create_links arasında paylaşılan 60 saniyelik pencere başına 30 bağlantı oluşturma çağrısı yapabilir. Her yükleme ayırma ve e-tablo gönderimi bir çağrı kullanır; alt bağlantı dönüştürmeleri çağrı kullanmaz. Anında işlenen istek de toplu iş gönderimi de içerdiği girdi sayısından bağımsız olarak bir çağrı kullanır.

Kabul edilen oluşturma istekleri ve kota nedeniyle reddedilenler yapılandırılmış başlıklar içerir:

RateLimit-Policy: "create-links";q=30;w=60
RateLimit: "create-links";r=29;t=60

q kota, w ise saniye cinsinden kota penceresidir. r kalan çağrı sayısıdır; t bir çağrılık yer açılana kadar geçecek saniyedir. Bunlar yalın sayılar değil, yapılandırılmış alanlardır.

Kota tükenince rate-limited sorunuyla ve saniye cinsinden Retry-After ile 429 döner. Yeniden denemeden önce bekleyin ve aynı hesabı kullanan istemcileri koordine edin. İşleri okumak bu bağlantı oluşturma kotasını tüketmez; işlerin poll_after_seconds ve Retry-After yönlendirmelerine uyun.

Arama penceresiBölüm bağlantısını kopyala

Anahtar sözcük aramalarının hesap başına 60 saniyede 30 çağrılık ayrı bir penceresi vardır. Arama kabulü, bağlantı oluşturma kotasını tüketmez. Ürün, mağaza, tablo veya desteklenmeyen bağlantı olarak çözümlenen yapıştırmalar anahtar sözcük aramasını atlar ve iki kotayı da tüketmez; okunamayan yapıştırmalar anahtar sözcük aramasına ulaşabilir.

Anahtar sözcük kabul aşamasına ulaşan başarılı yanıtlar ve arama sınırı nedeniyle reddedilenler şunları içerir:

RateLimit-Policy: "search";q=30;w=60
RateLimit: "search";r=29;t=60

Reddedilen aramalar, search-rate-limited ve Retry-After ile 429 döndürür. Başlık alanları yukarıdakiyle aynı anlama gelir. Idempotency-Key ile bir oluşturma isteğini yinelemek bağlantı oluşturma kotasından yeni bir çağrı tüketmez; 429 yineleme için saklanmaz.