İçeriğe atla
Geliştirici dokümanlarıAPI referansıHesap

Limitleri getir

Organizasyonunuz için geçerli limitler ve yeni işlerin fiyatlandırıldığı fiyat tarifesi.

GEThttps://runner.cargoduo.com/v1/limits

Kimlik doğrulama

Bearer API anahtarı, gereken yetki:account:readDaha fazla bilgi

Örnek istek

curl -X GET "https://runner.cargoduo.com/v1/limits" \
  -H "Authorization: Bearer $CARGODUO_API_KEY"

Örnek yanıt

200 OK · Limits
{
  "max_items_per_request": 2000,
  "max_vehicles_per_request": 20,
  "max_time_limit_seconds": 90,
  "allowed_vehicle_types": [
    "truck",
    "trailer",
    "container",
    "pallet"
  ],
  "concurrency": 1,
  "max_queued_jobs": 20,
  "rate_limits": {
    "per_minute": 60,
    "per_hour": 1000,
    "per_day": 5000
  },
  "retention_days": 14,
  "rate_card": {
    "version": 1,
    "per_job": 0.06,
    "per_vehicle": 0.2,
    "per_compute_second": 0.005,
    "large_load_threshold": 500,
    "per_hundred_items_over": 0.02
  }
}

Yanıtlar

  • 200OKLimitler ve fiyat tarifesi.
    AdTürZorunluAçıklama
    max_items_per_requestinteger
    integer
    Hayır

    İş başına en fazla öğe adedi (quantity değerlerinin toplamı).

    max_vehicles_per_requestinteger
    integer
    Hayır

    Bir işin listeleyip yükleyebileceği en fazla araç sayısı (otomatik eklenenler dahil).

    max_time_limit_secondsinteger
    integer
    Hayır

    İş başına hesaplama süresinin üst sınırı.

    allowed_vehicle_typesstring[]
    string[]
    Hayır

    API'nin kabul ettiği araç türleri.

    concurrencyinteger
    integer
    Hayır

    Organizasyonunuzun aynı anda hesaplanabilen iş sayısı; fazlası kuyrukta bekler.

    max_queued_jobsinteger
    integer
    Hayır

    Organizasyon başına sıradaki + çalışan iş sayısı.

    rate_limitsRateLimits
    RateLimits
    Hayır

    Pencere başına istek sayısı; anahtar ve organizasyon bazında.

    retention_daysinteger
    integer
    Hayır

    İstek/sonuç gövdelerinin ve PDF bağlantılarının saklandığı gün sayısı.

    rate_cardRateCard
    RateCard
    Hayır

    Kredi cinsinden fiyatlar (1 kredi = 1 USD).

  • 401Unauthorizedunauthorizedkey_revokedkey_expired
    • unauthorizedAPI anahtarı eksik, hatalı biçimde ya da tanınmıyor.
    • key_revokedAnahtar iptal edildi.
    • key_expiredAnahtarın geçerlilik süresi doldu.
    AdTürZorunluAçıklama
    errorErrorBodyzorunlu
    ErrorBody
    Evet
    Tüm hata kodları
  • 403Forbiddenip_not_allowedsubscription_inactiveaccount_inactivescope_missing
    • ip_not_allowedİsteği gönderen IP, anahtarın izin listesinde değil.
    • subscription_inactiveOrganizasyonun API'yi içeren etkin bir aboneliği yok.
    • account_inactiveOrganizasyon askıya alınmış ya da hesabı etkin olan bir organizasyon sahibi yok.
    • scope_missingAnahtarda bu endpoint'in gerektirdiği bir yetki eksik.
    AdTürZorunluAçıklama
    errorErrorBodyzorunlu
    ErrorBody
    Evet
    Tüm hata kodları
  • 429Too many requestsrate_limited
    • rate_limitedGeçerli dakika, saat ya da gün içinde çok fazla istek gönderildi (anahtar ya da organizasyon başına) veya IP adresinizden gelen başarısız kimlik doğrulama denemeleri dakikada 60 sınırını aştı.
    AdTürZorunluAçıklama
    errorErrorBodyzorunlu
    ErrorBody
    Evet
    Tüm hata kodları
  • 500Internal server errorinternal_error
    • internal_errorBizim tarafımızda bir hata oluştu.
    AdTürZorunluAçıklama
    errorErrorBodyzorunlu
    ErrorBody
    Evet
    Tüm hata kodları
  • 503Service unavailableapi_disabled
    • api_disabledAPI geçici olarak devre dışı (bakım) ya da organizasyon için kapatılmış.
    AdTürZorunluAçıklama
    errorErrorBodyzorunlu
    ErrorBody
    Evet
    Tüm hata kodları