StokisAI Academy
跨境电商

OZON API Key获取:Client-Id和密钥在哪里拿

发布 约 6 分钟读完

OZON 的 API 密钥在卖家后台生成,入口是「设置 → Seller API 和插件」。生成时要给密钥起名字、选个人或外部应用,密钥有效期 3 个月,而且只显示一次。对接 ERP 需要两样东西:账号对应的 Client ID 和这把 API 密钥,两样都要在生成后马上保存。

下面按我自己注册 OZON、再把它接进自己系统的顺序,讲清楚密钥在哪拿、拿之前要做完什么、拿到之后怎么交给系统用。

拿 API 密钥之前,要先做完哪些事?

API 密钥是卖家后台里的功能。所以第一步是把卖家账号注册好,能登进后台。

注册的完整步骤我在另一篇里按 16 步写过:OZON注册教程:16步完成入驻再对接API和搜同款。这里只列和 API 有关的前置条件:

  • 用 OZON ID 验证码登录卖家后台。
  • 在「选择公司」里添加公司,按营业执照填统一社会信用代码、组织英文法定名称、法人地址等信息。
  • 收款选连连,按「连接钱包 → 授权 → 确认绑定」走完。
  • 确认邮箱,合同显示「处于活动状态」。
  • 创建仓库、设置配送方式。

做完以后,后台首页会出现一个 5 步清单:付款资料、等待验证、签合同、上传商品、设置物流。我是在这些都走完之后,才去看 API 的。

我第一次点进 API 相关页面时,页面提示不让用,文档页面也打不开,显示拒绝连接。折腾了一阵才打开。遇到这种情况,先确认账号流程都走完了,再检查自己的网络环境,不要急着重新注册账号。

OZON Client ID 和 API Key 在哪里获取?

入口路径:

  1. 登录 OZON 卖家后台。
  2. 点「设置」。
  3. 找到「Seller API 和插件」。
  4. 在这个页面生成密钥。

生成后,密钥会出现在密钥列表里。我录屏时截图上能看到 Client ID 和密钥两项,对接系统时这两项都要填。页面上字段的具体叫法,以你后台看到的为准。

生成密钥时要填什么?

  • 命名:给这把密钥起一个名字。建议按用途起,比如写明是给哪个系统用的,以后列表里有好几把时能分清。
  • 类型:选个人或者外部应用。按谁来调用 API 选。两者的具体区别以官方说明为准。
  • 权限:按你要用的功能选。只想同步订单的,就不要把所有权限都勾上。

密钥有效期是多久?

我看到的说明是:密钥有效期为 3 个月。到期之后要重新生成,页面上可以查看密钥的到期日期。

这意味着对接完不是一劳永逸。建议在自己的日历或者系统里记一个提醒,到期前换新密钥,不然到了那天订单同步会直接断掉。

密钥为什么只能看到一次?

密钥生成后只显示一次。关掉页面之后就看不到完整内容了。

所以生成后第一件事是复制保存。保存的地方要安全:密码管理器,或者系统后台的配置页。不要存在随手的聊天记录里。

密钥泄露了怎么办?

我自己就遇到过。录屏的时候,我把生成好的访问密钥在屏幕上露出来了。发现后我马上重新生成了一把,旧的不再用。

Client ID 和 API 密钥加在一起,等于店铺的钥匙。拿到它的人可以通过 API 读你的订单、改你的价格和库存。所以:

  • 不要截图发群,截图前先把密钥打码。
  • 不要贴到公开的网页、文档、代码仓库里。
  • 一旦露出来,重新生成一把,旧的停用。
  • 录视频、开直播、远程给别人看屏幕时,先把这个页面关掉。

OZON Seller API 能做什么?

拿密钥之前,最好先弄清楚 API 能做什么,决定要不要对接、要开哪些权限。按我看的 API 文档,能做的事有这些:

类别 能做的事
商品管理 上传和更新商品,批量上架、下架
价格与库存 批量更新价格,更新 FBS 仓库库存
订单管理 获取 FBO / FBS 订单,获取待发货订单,更新配送状态
FBS 仓库操作 创建仓库、设置发货;FBS cross border 模式就是一件代发
数据分析 销售数据、仓库周转数据
财务报告 商品销售报告、交易明细
售后 退货与评级,处理取消订单
买家沟通 和买家聊天、发消息

OZON API 能查竞争对手的数据吗?

不能。我专门让 AI 帮我在 API 文档里找过分析板块,结论是:

  • API 只给你自己店铺的数据,没有查竞争对手的接口。
  • 没有以图搜图的 API。

市面上能查全平台数据的,基本是第三方工具,不是 OZON 官方 API。以图搜图只在买家端有,入口在搜索结果页搜索框右侧的相机图标,详细位置在上面那篇注册教程里写了。

拿到 Client ID 和 API Key 之后,怎么接进 ERP?

我的系统本来就是多平台的,之前接过独立站和亚马逊。这次接 OZON,我是这样跟 AI 说的,大意是:

我开了一个新的电商平台 OZON,请你帮我对接它的 API。我先把它的 API 文档发给你。API key 和 API 密钥我已经准备好了,请你在前端配置页面里留好位置,我自己填进去,然后你开始读取数据。

后面又补了一句:文档你自己读,不用去参考独立站和亚马逊那些写法,直接看 OZON 的 API 文档。我们本来就是多平台,再加一个平台进去就行。

这里面有三个要点:

  1. 给 AI 官方文档。不同平台的 API 写法差别很大。让 AI 照着别的平台去猜,容易写错。
  2. 密钥自己填在配置页。不要把 Client ID 和密钥直接贴在聊天框里,让系统做一个配置页面,自己手动填。
  3. 说清楚是在已有系统上加平台。这样 AI 会沿用原来的订单、商品结构,而不是重新搭一套。

如果你接过其他平台,流程是相通的。亚马逊的做法可以看 亚马逊SP-API对接ERP教程,eBay 的可以看 eBay对接ERP教程。

密钥应该放在前端还是后端?

我在资料里看到一条说明,大意是 OZON 的 API 只支持服务端调用,不支持在浏览器里直接请求。这条请自己核对官方文档。

不管官方怎么规定,从安全角度讲,密钥都应该存在服务端。前端页面只负责让你填写和修改,真正调用 API 的请求由后端发出。这样密钥不会出现在浏览器能看到的代码里。

对接前的检查清单

  • 卖家后台能正常登录,公司信息、收款、合同、仓库都已经完成。
  • 想清楚要用 API 做哪些事,按需选权限。
  • 在「设置 → Seller API 和插件」生成密钥,命名写清用途。
  • 生成后马上复制 Client ID 和密钥,存到安全的地方。
  • 记下 3 个月的到期时间,提前换新。
  • 把官方 API 文档交给 AI 或开发者,密钥自己填在配置页。
  • 密钥露出过,就重新生成。

常见问题

密钥过期了数据会丢吗?

密钥过期影响的是系统能不能继续调用 API,比如拉不到新订单。店铺里的数据还在后台。换一把新密钥填进配置页,就能继续同步。

OZON API 能做以图搜图吗?

不能。以图搜图只在买家端,入口在搜索结果页搜索框右侧的相机图标。

如果你想把 OZON、亚马逊、eBay 这些平台接进同一个系统,自己管订单和商品,可以看看 AI 系统打造课程,里面讲的是怎么用 AI 一步步搭这样的系统。

跨境电商 × AI 应用实践者。做 Etsy、亚马逊多店铺运营,自建 ERP 与选品系统,公众号「跨境AI小田田」。

线下实战课

跟着做一遍,带你跑通跨境电商 + AI 全流程。

查看课程详情

相关课程

Etsy 店群运营课:从店铺认知、选品、上架到广告、站外和风险,两天把拿到手的店跑起来。第二期主讲 Etsy,同时带上 eBay 等多平台和多店群的做法,选品加讲自动化。

看课程