Rate Limits & Kontingente

API-Nutzung wird durch Rate Limits pro Minute und tägliche Kontingente pro Channel (abrechenbare Einheiten) begrenzt. Limits werden beim App-Onboarding anhand des erwarteten Transaktionsvolumens festgelegt - siehe Zulässige Nutzung.

Strukturierte Limits und Header: data/rate-limits.json.

Rate Limit pro Minute {#rate-limits}

Standard: 60 Anfragen/Minute pro API-Schlüssel (abhängig vom Plan). Überschreitung → HTTP 429 mit RATE_LIMIT_EXCEEDED.

Tägliches Channel-Kontingent (abrechenbare Einheiten) {#daily-quota}

Viele Routen verbrauchen abrechenbare Einheiten gegen ein tägliches Limit pro Channel (1688, Taobao). Beispiele:

Route	Typische Einheiten
POST /v1/products/detail	1
POST /v1/products/search	2
POST /v1/products/upload-image	2
POST /v1/orders/preview, create	Höheres Gewicht - siehe Plan

Wenn das Tageslimit erschöpft ist → HTTP 429 mit QUOTA_EXCEEDED. Kontaktieren Sie HIOBuy, um Limits zu erhöhen, wenn Ihr GMV wächst.

Response-Header {#response-headers}

Erfolgreiche abrechenbare Aufrufe können enthalten:

Header	Beschreibung
X-Quota-Billable-Units	Von dieser Anfrage verbrauchte Einheiten
X-Quota-Channel	Channel, dem die Einheiten belastet wurden (z. B. 1688)
x-request-id	Request-Korrelations-ID (alle Routen)

Plattformkapazität {#platform-quota}

Selten kann gemeinsame Upstream-Kapazität vorübergehend nicht verfügbar sein → PLATFORM_QUOTA_EXCEEDED (429). Später erneut versuchen oder Support kontaktieren.

Client-Empfehlungen {#handling}

• Cachen Sie Produktdetailantworten, sofern Geschäftsregeln es erlauben.
• Verwenden Sie nach upload-image bevorzugt image_id wieder, statt erneut hochzuladen.
• Bei 429 Backoff anwenden; error.request_id lesen - siehe Fehler.
• Überwachen Sie die Nutzung im Usage-Dashboard des Developer Portals.