Limites de débit et quotas

L’utilisation de l’API est limitée par des limites de débit par minute et des quotas quotidiens par canal (unités facturables). Les limites sont définies lors de l’onboarding de l’app selon le volume de transactions attendu — voir Utilisation acceptable.

Limites structurées et en-têtes : data/rate-limits.json.

Limite de débit par minute {#rate-limits}

Par défaut : 60 requêtes/minute par clé API (selon le plan). Dépassement → HTTP 429 avec RATE_LIMIT_EXCEEDED.

Quota quotidien de canal (unités facturables) {#daily-quota}

De nombreuses routes consomment des unités facturables sur un plafond quotidien par canal (1688, Taobao). Exemples :

Route	Unités typiques
POST /v1/products/detail	1
POST /v1/products/search	2
POST /v1/products/upload-image	2
POST /v1/orders/preview, create	Poids plus élevé — voir le plan

Lorsque le plafond quotidien est épuisé → HTTP 429 avec QUOTA_EXCEEDED. Contactez HIOBuy pour augmenter les limites à mesure que votre GMV grandit.

En-têtes de réponse {#response-headers}

Les appels facturables réussis peuvent inclure :

En-tête	Description
X-Quota-Billable-Units	Unités consommées par cette requête
X-Quota-Channel	Canal auquel les unités ont été imputées (par ex. 1688)
x-request-id	ID de corrélation de requête (toutes les routes)

Capacité de plateforme {#platform-quota}

Rarement, la capacité upstream partagée peut être temporairement indisponible → PLATFORM_QUOTA_EXCEEDED (429). Réessayez plus tard ou contactez le support.

Recommandations client {#handling}

• Mettez en cache les réponses de détail produit lorsque vos règles métier le permettent.
• Préférez réutiliser image_id après upload-image plutôt que de téléverser à nouveau.
• Appliquez un backoff sur 429 ; lisez error.request_id — voir Erreurs.
• Surveillez l’utilisation dans le tableau de bord d’usage du portail développeur.