Aller au contenu
Documentation développeursRéférence de l'APICompte

Consulter les limites

Les limites applicables à votre organisation et la grille tarifaire appliquée aux nouvelles tâches.

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

Authentification

Clé API Bearer avec l'autorisationaccount:readEn savoir plus

Exemple de requête

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

Exemple de réponse

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

Réponses

  • 200OKLimites et grille tarifaire.
    NomTypeObligatoireDescription
    max_items_per_requestinteger
    integer
    Non

    Nombre maximal d'unités d'articles (somme des quantités) par tâche.

    max_vehicles_per_requestinteger
    integer
    Non

    Nombre maximal de véhicules qu'une tâche peut lister et charger (y compris ceux ajoutés automatiquement).

    max_time_limit_secondsinteger
    integer
    Non

    Plafond du budget de calcul par tâche.

    allowed_vehicle_typesstring[]
    string[]
    Non

    Types de véhicules acceptés par l'API.

    concurrencyinteger
    integer
    Non

    Tâches de votre organisation calculées simultanément ; les autres attendent dans la file.

    max_queued_jobsinteger
    integer
    Non

    Tâches en file d'attente + en cours par organisation.

    rate_limitsRateLimits
    RateLimits
    Non

    Requêtes par fenêtre, par clé et par organisation.

    retention_daysinteger
    integer
    Non

    Durée de conservation, en jours, des corps de requête et de résultat et des liens PDF.

    rate_cardRateCard
    RateCard
    Non

    Prix en crédits (1 crédit = 1 USD).

  • 401Unauthorizedunauthorizedkey_revokedkey_expired
    • unauthorizedClé API absente, mal formée ou inconnue.
    • key_revokedLa clé a été révoquée.
    • key_expiredLa clé a dépassé sa date d'expiration.
    NomTypeObligatoireDescription
    errorErrorBodyobligatoire
    ErrorBody
    Oui
    Tous les codes d'erreur
  • 403Forbiddenip_not_allowedsubscription_inactiveaccount_inactivescope_missing
    • ip_not_allowedL'adresse IP appelante ne figure pas dans la liste des adresses IP autorisées de la clé.
    • subscription_inactiveL'organisation n'a aucun abonnement actif incluant l'API.
    • account_inactiveL'organisation est suspendue ou n'a aucun propriétaire dont le compte est actif.
    • scope_missingIl manque à la clé une autorisation requise par cet endpoint.
    NomTypeObligatoireDescription
    errorErrorBodyobligatoire
    ErrorBody
    Oui
    Tous les codes d'erreur
  • 429Too many requestsrate_limited
    • rate_limitedTrop de requêtes dans la minute, l'heure ou la journée en cours (par clé ou par organisation), ou plus de 60 échecs d'authentification par minute depuis votre adresse IP.
    NomTypeObligatoireDescription
    errorErrorBodyobligatoire
    ErrorBody
    Oui
    Tous les codes d'erreur
  • 500Internal server errorinternal_error
    • internal_errorUne erreur s'est produite de notre côté.
    NomTypeObligatoireDescription
    errorErrorBodyobligatoire
    ErrorBody
    Oui
    Tous les codes d'erreur
  • 503Service unavailableapi_disabled
    • api_disabledL'API est temporairement désactivée (maintenance) ou désactivée pour l'organisation.
    NomTypeObligatoireDescription
    errorErrorBodyobligatoire
    ErrorBody
    Oui
    Tous les codes d'erreur