Saltar al contenido
Documentación para desarrolladoresReferencia de la APICuenta

Consultar los límites

Los límites que se aplican a tu organización y la tarifa con la que se calcula el precio de los trabajos nuevos.

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

Autenticación

Clave de API Bearer con el permisoaccount:readMás información

Ejemplo de solicitud

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

Ejemplo de respuesta

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

Respuestas

  • 200OKLímites y tarifa.
    NombreTipoObligatorioDescripción
    max_items_per_requestinteger
    integer
    No

    Máximo de unidades de artículos (suma de cantidades) por trabajo.

    max_vehicles_per_requestinteger
    integer
    No

    Máximo de vehículos que un trabajo puede indicar y cargar (incluidos los añadidos automáticamente).

    max_time_limit_secondsinteger
    integer
    No

    Presupuesto de cómputo máximo por trabajo.

    allowed_vehicle_typesstring[]
    string[]
    No

    Tipos de vehículo que acepta la API.

    concurrencyinteger
    integer
    No

    Trabajos de tu organización que se calculan a la vez; el resto espera en la cola.

    max_queued_jobsinteger
    integer
    No

    Trabajos en cola + en curso por organización.

    rate_limitsRateLimits
    RateLimits
    No

    Solicitudes por ventana, por clave y por organización.

    retention_daysinteger
    integer
    No

    Días que se conservan los cuerpos de solicitud y de resultado y los enlaces a PDF.

    rate_cardRateCard
    RateCard
    No

    Precios en créditos (1 crédito = 1 USD).

  • 401Unauthorizedunauthorizedkey_revokedkey_expired
    • unauthorizedClave de API ausente, mal formada o desconocida.
    • key_revokedLa clave se ha revocado.
    • key_expiredLa clave ha superado su fecha de caducidad.
    NombreTipoObligatorioDescripción
    errorErrorBodyobligatorio
    ErrorBody
    Sí
    Todos los códigos de error
  • 403Forbiddenip_not_allowedsubscription_inactiveaccount_inactivescope_missing
    • ip_not_allowedLa IP de origen no está en la lista de IP permitidas de la clave.
    • subscription_inactiveLa organización no tiene ninguna suscripción activa que incluya la API.
    • account_inactiveLa organización está suspendida o no tiene ningún propietario con la cuenta activa.
    • scope_missingA la clave le falta un permiso que requiere este endpoint.
    NombreTipoObligatorioDescripción
    errorErrorBodyobligatorio
    ErrorBody
    Sí
    Todos los códigos de error
  • 429Too many requestsrate_limited
    • rate_limitedDemasiadas solicitudes en el minuto, la hora o el día en curso (por clave o por organización), o más de 60 autenticaciones fallidas por minuto desde tu dirección IP.
    NombreTipoObligatorioDescripción
    errorErrorBodyobligatorio
    ErrorBody
    Sí
    Todos los códigos de error
  • 500Internal server errorinternal_error
    • internal_errorAlgo ha fallado por nuestra parte.
    NombreTipoObligatorioDescripción
    errorErrorBodyobligatorio
    ErrorBody
    Sí
    Todos los códigos de error
  • 503Service unavailableapi_disabled
    • api_disabledLa API está desactivada temporalmente (mantenimiento) o deshabilitada para la organización.
    NombreTipoObligatorioDescripción
    errorErrorBodyobligatorio
    ErrorBody
    Sí
    Todos los códigos de error