Límites de tasa y cuotas
El uso de la API está limitado por límites de tasa por minuto y cuotas diarias por canal (unidades facturables). Los límites se establecen durante el onboarding de la app según el volumen transaccional esperado; consulta Uso aceptable.
Límites y encabezados estructurados: data/rate-limits.json.
Límite de tasa por minuto {#rate-limits}
Predeterminado: 60 solicitudes/minuto por clave API (sujeto al plan). Si se supera → HTTP 429 con RATE_LIMIT_EXCEEDED.
Cuota diaria por canal (unidades facturables) {#daily-quota}
Muchas rutas consumen unidades facturables contra un límite diario por canal (1688, Taobao). Ejemplos:
| Ruta | Unidades típicas |
|---|---|
POST /v1/products/detail | 1 |
POST /v1/products/search | 2 |
POST /v1/products/upload-image | 2 |
POST /v1/orders/preview, create | Peso mayor; consulta el plan |
Cuando se agota el límite diario → HTTP 429 con QUOTA_EXCEEDED. Contacta con HIOBuy para aumentar límites a medida que crece tu GMV.
Encabezados de respuesta {#response-headers}
Las llamadas facturables exitosas pueden incluir:
| Encabezado | Descripción |
|---|---|
X-Quota-Billable-Units | Unidades consumidas por esta solicitud |
X-Quota-Channel | Canal contra el que se cargaron las unidades (por ejemplo, 1688) |
x-request-id | Id de correlación de solicitud (todas las rutas) |
Capacidad de plataforma {#platform-quota}
En raras ocasiones, la capacidad upstream compartida puede estar temporalmente no disponible → PLATFORM_QUOTA_EXCEEDED (429). Reintenta más tarde o contacta con soporte.
Recomendaciones para clientes {#handling}
- Cachea las respuestas de detalle de producto cuando las reglas de negocio lo permitan.
- Prefiere reutilizar
image_iddespués deupload-imageen lugar de volver a cargar. - Haz backoff en
429; leeerror.request_id; consulta Errores. - Monitorea el uso en el panel de uso del portal de desarrolladores.