Лимиты запросов и квоты
Использование API ограничено поминутными rate limits и дневными квотами по каналам (billable units). Лимиты задаются во время onboarding приложения на основе ожидаемого объема транзакций — см. допустимое использование.
Структурированные лимиты и заголовки: data/rate-limits.json.
Поминутный rate limit {#rate-limits}
По умолчанию: 60 запросов/минуту на API-ключ (зависит от plan). Превышение → HTTP 429 с RATE_LIMIT_EXCEEDED.
Дневная квота канала (billable units) {#daily-quota}
Многие routes расходуют billable units из дневного лимита по каналу (1688, Taobao). Примеры:
| Route | Типичные units |
|---|---|
POST /v1/products/detail | 1 |
POST /v1/products/search | 2 |
POST /v1/products/upload-image | 2 |
POST /v1/orders/preview, create | Более высокий вес — см. plan |
Когда дневной лимит исчерпан → HTTP 429 с QUOTA_EXCEEDED. Свяжитесь с HIOBuy, чтобы увеличить лимиты по мере роста вашего GMV.
Response headers {#response-headers}
Успешные billable calls могут включать:
| Header | Описание |
|---|---|
X-Quota-Billable-Units | Units, израсходованные этим запросом |
X-Quota-Channel | Канал, на который были списаны units (например, 1688) |
x-request-id | Request correlation id (все routes) |
Platform capacity {#platform-quota}
Редко общая upstream capacity может быть временно недоступна → PLATFORM_QUOTA_EXCEEDED (429). Повторите позже или обратитесь в поддержку.
Рекомендации для клиента {#handling}
- Кэшируйте product detail responses там, где это позволяют бизнес-правила.
- Предпочитайте повторное использование
image_idпослеupload-imageвместо повторной загрузки. - Делайте backoff при
429; читайтеerror.request_id— см. ошибки. - Мониторьте usage в usage dashboard портала разработчика.