Ozon API 提示 429 限流怎么办?三种情况分开处理

Q: Ozon API 提示 429 限流怎么办?三种情况分开处理

429 分三种:每秒突发稍等重试;同一 SKU 同仓 2 分钟内重复改库存要等冷却;单独发一次仍 429 是账号级限流,重试无效,需停共用工具、换 API Key 或找 Ozon 客服。

维护方：极掌帮助中心 · 最后更新：2026-09-26

Ozon API 返回 429 就是请求太频繁,要分三种情况处理。一是瞬间请求太多,稍等几秒重试即可。二是同一 SKU 在同一仓库 2 分钟内重复改库存,等冷却结束再推。三是账号级限流:单独发一次请求也返回 429,重试没用,要停掉共用这个 API Key 的其他工具、重新生成 Key,或者找 Ozon 客服。

四种常见 429 场景

场景	典型报错	限制口径	能不能等它自己恢复	怎么办
每秒突发	`429`,code 8,`You have reached request rate limit per second`	按 Client ID + 接口,秒级	能,几秒内恢复	降低并发,稍等后重试
库存更新太频繁	`TOO_MANY_REQUESTS`,`Stock is updated too frequently`	同一 SKU 同一仓库每 2 分钟 1 次	能,2 分钟后恢复	先合并改动,只推最终数量
商品导入被限流	`/v3/product/import` 返回 429	Ozon 平台侧的时间窗口,可能同时影响很多店铺	能,通常持续数分钟到十几分钟	等一会儿再提交;重提前先确认商品有没有已经建好
账号级限流	空闲时单独发一次请求仍返回 429	针对这个 Client ID	不能,一直重试也失败	按下文三步处理

怎么判断是不是账号级限流

关键看空闲时单独发一次请求是否还返回 429:

暂停这个店铺在所有工具里的任务,几分钟后只发一个很轻的请求(比如查询卖家信息)。
返回 200:之前的 429 是瞬间请求太多,降低并发就行。
仍然返回 429:基本就是账号级限流。换网络、换服务器都没用,同一时间用别的店铺凭证请求却正常,就更能确认。

极掌排查持续报 429 的店铺时,多数是账号级限流,少数其实是 API Key 已被停用(403 Api-key is deactivated)。这些店铺的商品同步往往在报错前几天就已经停了,只是到上架时才被发现。

账号级限流按这三步处理:

停掉共用这个 API Key 的其他工具。同一个 Client ID 同时接了多个 ERP、脚本,或在多个系统里重复绑定时,这些调用共用同一份每秒额度。
在 Ozon 卖家后台「设置 → API 密钥」重新生成 API Key,再到各工具里更新。
仍然不恢复,就用这个店铺账号在 seller.ozon.ru 提交工单,请 Ozon 客服排查。

429 期间别盲目重提上架

商品导入不是幂等操作。提交可能在 Ozon 端已经成功了,只是你没收到结果。这时直接重提,可能建出重复商品,或者覆盖已有的商品卡。重提前先按货号(offer_id)在后台搜一下,确认商品还没建好再重提。

用极掌ERP 上架时,如果看到 Pre-import lookup failed (status=429),说明上架前的查重请求被限流了。系统会中止这次提交,避免重复建品。如果连续几次都是这个错误,多半是账号级限流,请按上面三步处理。

和「后台限制登录」不是一回事

官方 Seller API(Client ID + API Key)超限只会返回 429,不会让你的卖家后台被限制登录。
在 seller.ozon.ru 网页后台遇到验证码或限制登录,是网页端风控,通常由短时间内大量网页操作触发,跟 API Key 无关。

降低 429 的日常做法

同一个 Client ID 只接必要的工具,避免多个系统同时全量同步。
批量改库存、改价时,把改动合并成一次提交,不要逐条连续推。
大批量上架时分批提交,遇到 429 先暂停,不要马上连续重试。

凭证类报错(400 / 403 等)见 Ozon 绑定店铺失败怎么判断;库存类报错见 Ozon 库存改不上去怎么办。

数据来源与口径

报错原文:Ozon Seller API(api-seller.ozon.ru)实际返回。
「同一 SKU 同一仓库 2 分钟只能改一次库存」:Ozon 库存接口频率限制。
商品导入限流:极掌对接中观察到 /v3/product/import 的 429 会在短时间窗口内同时出现在多个店铺,判断为 Ozon 平台侧限流;具体额度以 Ozon 官方文档为准。
账号级限流排查:2026-08 极掌对 10 个持续报 429 的店铺逐个探测的结果。
更新于 2026-09-26。