Przejdź do treści
Dokumentacja dla deweloperówDokumentacja APIKonto

Pobierz limity

Limity obowiązujące Twoją organizację i cennik, według którego wyceniane są nowe zadania.

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

Uwierzytelnianie

Klucz API (Bearer) z zakresemaccount:readWięcej informacji

Przykładowe zapytanie

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

Przykładowa odpowiedź

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
  }
}

Odpowiedzi

  • 200OKLimity i cennik.
    NazwaTypWymaganyOpis
    max_items_per_requestinteger
    integer
    Nie

    Maksymalna liczba sztuk (suma ilości) na zadanie.

    max_vehicles_per_requestinteger
    integer
    Nie

    Maksymalna liczba pojazdów, które zadanie może wymienić i załadować (łącznie z dodanymi automatycznie).

    max_time_limit_secondsinteger
    integer
    Nie

    Górny limit budżetu obliczeniowego na zadanie.

    allowed_vehicle_typesstring[]
    string[]
    Nie

    Typy pojazdów akceptowane przez API.

    concurrencyinteger
    integer
    Nie

    Liczba zadań Twojej organizacji liczonych jednocześnie; kolejne czekają w kolejce.

    max_queued_jobsinteger
    integer
    Nie

    Zadania w kolejce + w toku na organizację.

    rate_limitsRateLimits
    RateLimits
    Nie

    Zapytania na okno czasowe, na klucz i na organizację.

    retention_daysinteger
    integer
    Nie

    Liczba dni przechowywania treści zapytań i wyników oraz linków do PDF.

    rate_cardRateCard
    RateCard
    Nie

    Ceny w kredytach (1 kredyt = 1 USD).

  • 401Unauthorizedunauthorizedkey_revokedkey_expired
    • unauthorizedBrak klucza API, nieprawidłowy format klucza lub nieznany klucz.
    • key_revokedKlucz został unieważniony.
    • key_expiredKlucz utracił ważność.
    NazwaTypWymaganyOpis
    errorErrorBodywymagane
    ErrorBody
    Tak
    Wszystkie kody błędów
  • 403Forbiddenip_not_allowedsubscription_inactiveaccount_inactivescope_missing
    • ip_not_allowedAdresu IP, z którego przyszło wywołanie, nie ma na liście dozwolonych adresów klucza.
    • subscription_inactiveOrganizacja nie ma aktywnej subskrypcji obejmującej API.
    • account_inactiveOrganizacja jest zawieszona albo nie ma właściciela z aktywnym kontem.
    • scope_missingKlucz nie ma zakresu wymaganego przez ten endpoint.
    NazwaTypWymaganyOpis
    errorErrorBodywymagane
    ErrorBody
    Tak
    Wszystkie kody błędów
  • 429Too many requestsrate_limited
    • rate_limitedZa dużo zapytań w bieżącej minucie, godzinie lub dobie (na klucz lub na organizację) albo przekroczony limit nieudanych uwierzytelnień z Twojego adresu IP (60 na minutę).
    NazwaTypWymaganyOpis
    errorErrorBodywymagane
    ErrorBody
    Tak
    Wszystkie kody błędów
  • 500Internal server errorinternal_error
    • internal_errorWystąpił błąd po naszej stronie.
    NazwaTypWymaganyOpis
    errorErrorBodywymagane
    ErrorBody
    Tak
    Wszystkie kody błędów
  • 503Service unavailableapi_disabled
    • api_disabledAPI jest tymczasowo wyłączone (prace konserwacyjne) lub wyłączone dla organizacji.
    NazwaTypWymaganyOpis
    errorErrorBodywymagane
    ErrorBody
    Tak
    Wszystkie kody błędów