Documentation Index
Fetch the complete documentation index at: https://docs.payven.com.tr/llms.txt
Use this file to discover all available pages before exploring further.
Payven, tüm API’lerinde kuruluş seviyesinde istek limitleri uygular. Bu limitler abuse engelleme ve adil kaynak paylaşımı içindir.
Limitler
Limitler planınıza göre değişir. Tipik değerler:
| Plan | Saniyedeki istek (RPS) | Burst |
|---|
| Sandbox | 50 | 100 |
| Standart | 200 | 400 |
| Yüksek hacim | 1000+ | Anlaşmalı |
Yanıt başlıkları
Her API yanıtı, mevcut kotanızı bildiren başlıklar döner:
X-RateLimit-Limit: 200
X-RateLimit-Remaining: 187
X-RateLimit-Reset: 1714742400
| Başlık | Açıklama |
|---|
X-RateLimit-Limit | Saniyedeki maksimum istek sayısı |
X-RateLimit-Remaining | Bu pencerede kalan istek hakkı |
X-RateLimit-Reset | Limitin sıfırlanacağı Unix timestamp |
Limit aşımı
Kotanız aşıldığında 429 Too Many Requests döner:
{
"isSuccess": false,
"code": "RATE_LIMIT_EXCEEDED",
"message": "İstek limiti aşıldı. Lütfen biraz sonra tekrar deneyin."
}
Retry-After başlığı bulunur — bu süre kadar (saniye) bekleyip yeniden deneyebilirsiniz.
Önerilen istemci davranışı
async Task<HttpResponseMessage> SendWithBackoff(HttpRequestMessage request)
{
while (true)
{
var response = await http.SendAsync(request);
if (response.StatusCode != (HttpStatusCode)429) return response;
var retryAfter = response.Headers.RetryAfter?.Delta
?? TimeSpan.FromSeconds(1);
await Task.Delay(retryAfter);
}
}
Webhook teslimi rate limit’inden muaftır
Sizin endpoint’inize Payven’in gönderdiği webhook çağrıları bu limitlere dahil değildir — ayrı bir teslim mekanizmasına tabidir. Detay: Webhook Yeniden Deneme.
Limit artırma talebi
Yüksek hacim ihtiyacınız varsa destek ekibimize ulaşın. Tipik onboarding 1-2 iş günü sürer.
