Zum Inhalt springen
EntwicklerdokumentationAPI-ReferenzKonto

Limits abrufen

Die Limits Ihrer Organisation und die Preisliste, nach der neue Jobs berechnet werden.

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

Authentifizierung

Bearer-API-Schlüssel mit Berechtigungaccount:readMehr erfahren

Beispielanfrage

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

Beispielantwort

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

Antworten

  • 200OKLimits und Preisliste.
    NameTypErforderlichBeschreibung
    max_items_per_requestinteger
    integer
    Nein

    Höchstzahl an Artikeleinheiten (Summe der Mengen) pro Job.

    max_vehicles_per_requestinteger
    integer
    Nein

    Höchstzahl an Fahrzeugen, die ein Job angeben und beladen darf (automatisch hinzugefügte eingeschlossen).

    max_time_limit_secondsinteger
    integer
    Nein

    Obergrenze des Rechenzeitbudgets pro Job.

    allowed_vehicle_typesstring[]
    string[]
    Nein

    Fahrzeugtypen, die die API akzeptiert.

    concurrencyinteger
    integer
    Nein

    Jobs Ihrer Organisation, die gleichzeitig berechnet werden; weitere warten in der Warteschlange.

    max_queued_jobsinteger
    integer
    Nein

    Wartende + laufende Jobs pro Organisation.

    rate_limitsRateLimits
    RateLimits
    Nein

    Anfragen pro Zeitfenster, pro Schlüssel und pro Organisation.

    retention_daysinteger
    integer
    Nein

    Tage, die Anfrage-/Ergebnis-Bodies und PDF-Links aufbewahrt werden.

    rate_cardRateCard
    RateCard
    Nein

    Preise in Credits (1 Credit = 1 USD).

  • 401Unauthorizedunauthorizedkey_revokedkey_expired
    • unauthorizedAPI-Schlüssel fehlt, ist fehlerhaft oder unbekannt.
    • key_revokedDer Schlüssel wurde widerrufen.
    • key_expiredDer Schlüssel ist abgelaufen.
    NameTypErforderlichBeschreibung
    errorErrorBodyerforderlich
    ErrorBody
    Ja
    Alle Fehlercodes
  • 403Forbiddenip_not_allowedsubscription_inactiveaccount_inactivescope_missing
    • ip_not_allowedDie aufrufende IP-Adresse steht nicht auf der Allowlist des Schlüssels.
    • subscription_inactiveDie Organisation hat kein aktives Abonnement, das die API enthält.
    • account_inactiveDie Organisation ist gesperrt oder hat keinen Inhaber mit aktivem Konto.
    • scope_missingDem Schlüssel fehlt eine Berechtigung, die dieser Endpoint benötigt.
    NameTypErforderlichBeschreibung
    errorErrorBodyerforderlich
    ErrorBody
    Ja
    Alle Fehlercodes
  • 429Too many requestsrate_limited
    • rate_limitedZu viele Anfragen in der aktuellen Minute, Stunde oder am aktuellen Tag (pro Schlüssel oder pro Organisation) oder mehr als 60 fehlgeschlagene Authentifizierungen pro Minute von Ihrer IP-Adresse.
    NameTypErforderlichBeschreibung
    errorErrorBodyerforderlich
    ErrorBody
    Ja
    Alle Fehlercodes
  • 500Internal server errorinternal_error
    • internal_errorAuf unserer Seite ist ein Fehler aufgetreten.
    NameTypErforderlichBeschreibung
    errorErrorBodyerforderlich
    ErrorBody
    Ja
    Alle Fehlercodes
  • 503Service unavailableapi_disabled
    • api_disabledDie API ist vorübergehend deaktiviert (Wartung) oder für die Organisation abgeschaltet.
    NameTypErforderlichBeschreibung
    errorErrorBodyerforderlich
    ErrorBody
    Ja
    Alle Fehlercodes