账号与店铺
Ozon 绑定店铺失败:Client ID / API Key 报错怎么判断?
绑定 Ozon 店铺失败,先看 HTTP 状态码。400 和 404 基本是 Client ID 或 API Key 填错,或者两者不属于同一个账号;401 是有一项没填。403 说明 Ozon 认识这个密钥,但在账号层面拒绝了,可能是密钥过期、被停用、API 权限被关停,或者商户号被封。
状态码对照表
| HTTP | Ozon code | 原文(节选) | 含义 | 处理 |
|---|---|---|---|---|
| 400 | 3 | Client-Id header value should be positive integer | Client ID 不是纯数字(混入了空格、字母或中文标点),或者没填 | 只填卖家后台那串数字 |
| 400 | 3 | Invalid Api-Key, please check the key and try again | API Key 格式不对(不是完整的 UUID 形状) | 重新完整复制,检查首尾有没有漏字符 |
| 404 | 5 | Invalid Api-Key, please check the key and try again | Key 格式对,但 Ozon 不认识,或者和 Client ID 不属于同一个账号 | 确认两者来自同一个 Ozon 账号;旧 Key 就重新生成一个 |
| 401 | 16 | Client-Id and Api-Key headers are required | Client ID 或 API Key 有一项为空 | 补齐两项 |
| 403 | 7 | 见下表 | Ozon 认识这个密钥,但账号或权限层面拒绝 | 按原文分诊 |
| 429 | 8 | You have reached request rate limit per second | 同一个 Client ID 这一秒请求太多,不是凭证错误 | 等几秒重试;停掉同时在跑的其他工具 |
同样一句
Invalid Api-Key,既可能返回 400 也可能返回 404。所以判断时要看 message 原文,不能只看状态码。403 code 7:按原文区分
| 原文 | 含义 | 重新生成 Key 能解决吗 | 处理 |
|---|---|---|---|
Api-key has expired, generate a new one | API Key 已过期 | 能 | 卖家后台「设置 → API 密钥」生成新 Key 后重新绑定 |
Api-key is deactivated | API Key 已被停用(手动停用或安全冻结) | 能 | 同上 |
Api access disabled, please contact support | 整个商户号的 API 访问权限被 Ozon 关停 | 不能 | 用店铺账号在 seller.ozon.ru 提交工单,请 Ozon 恢复 API 权限 |
Company is blocked, please contact support | 商户号被 Ozon 封禁 | 不能 | 见 Ozon 返回 403 COMPANY_BLOCKED 是什么意思 |
...CheckChatEnabled failed: chat disabled | 只是店铺的聊天功能关着 | 不涉及 | 跟凭证无关,不影响绑定和商品操作 |
极掌对接中遇到的 403 code 7 里,
Api access disabled(整个商户号 API 被关停)出现得最多,其次是 Key 过期;前者重新生成 Key 也解决不了。绑定前自查清单
- Client ID:只填纯数字,不带空格和其他字符。
- API Key:在 Ozon 卖家后台「设置 → API 密钥」生成,完整复制,不要只截取一部分。
- 同一账号:Client ID 和 API Key 必须来自同一个 Ozon 卖家账号。多店卖家最容易在这里填串。
- 旧 Key:很久以前保存的 Key 可能已经过期或被停用,直接生成一个新的更省事。
- 偶发限流:看到
rate limit per second,通常是同一个 Client ID 正被其他 ERP 或脚本调用,几秒后重试即可。持续出现时见 Ozon API 提示 429 限流怎么办。
在极掌ERP 里绑定失败时,页面会按 Ozon 原文给出中文处理建议。已绑定的店铺如果之后 Key 失效,首页会提示「Ozon API Key 已失效」;生成新 Key 后,在店铺设置里点「更换 API Key 并恢复」即可。遇到「API 权限被关停」或「商户号被封」,要先在 Ozon 处理完,再回来点「重新启用」。
数据来源与口径
- 状态码、code 与原文:极掌直连 Ozon Seller API
/v1/seller/info实测,2026-09-09。 - 403 code 7 分布:极掌生产环境 2026-09 连续 12 小时的采样。
- 「设置 → API 密钥」入口名称以 Ozon 卖家后台当前界面为准。
- 更新于 2026-09-26。