跳到正文
海云星AI海云星AI产品帮助中心进入 ERP
店铺与账号
店铺与账号

海云星产品操作指南

eMAG 店铺 API 授权教程|API 代码、账号权限与 IP 白名单

在 eMAG 罗马尼亚站卖家后台找到 API 代码,准备有 API 权限的用户名和密码,分别添加海云星的两个服务器出口 IP 白名单,按脱敏截图核对有效状态,并排查 IP、权限及多站点连接问题。

海云星产品团队更新于 约 7 分钟阅读
本文目录 7 个小节

eMAG 店铺 API 授权与 IP 白名单配置

连接 eMAG 店铺前,需要准备有 API 权限的用户名和密码,并在卖家后台添加海云星服务器的固定公网出口 IP。本教程以罗马尼亚站(eMAG.ro)中文后台为例,说明如何找到 API 代码、设置 IP 白名单和核验连接。

截图中的店铺名称、API 代码、用户名及示例账号已有的 IP 均已打码。下文列出的两个海云星服务器 IP 用于配置白名单,请原样填写;账号凭证请使用自己的真实信息。

1 开始前准备

  • 一个已开通的 eMAG 卖家账号,并能进入该店铺的技术详情页面。
  • 一个具有 API 访问权限的 eMAG 用户,以及该用户对应的密码。能登录卖家后台不代表已获得 API 权限。
  • 海云星服务器的两个公网出口 IP:120.76.228.68 和 47.115.74.60,两个都需要添加。
  • 确认要连接的站点。本教程使用 RO 站;如需连接 BG、HU 站,应分别确认对应站点的账号权限和白名单。

IP 白名单要填海云星服务器访问 eMAG 时使用的公网出口 IP。 个人电脑 IP、内网 IP、网站域名,以及其他 ERP 服务商提供的 IP,都不能直接代替它。

2 打开技术详情页面

  1. 登录 eMAG 罗马尼亚站卖家后台。
  2. 核对右上角的店铺和站点。
  3. 依次进入 我的账户 → 个人资料 → 技术详情。

英文后台对应路径为 My Account → Profile → Technical Details。已经登录的用户也可以直接打开技术详情页面。该入口与 eMAG 的官方技术详情说明一致。

图中 ① 为技术详情页签,② 为 API 代码,③ 为添加 IP 的入口。

3 查看 API 代码并准备凭证

在页面上方的“设置”区域找到 API 代码(API Code),按接入要求复制或记录。该字段在示例页面中为只读。

连接资料分别对应以下用途:

信息 应当填写什么
站点 实际需要连接的 eMAG 销售站点,例如罗马尼亚 RO
API 用户名 具有 API 权限的 eMAG 用户名;使用专用 API 用户时填写该用户
密码 上述 API 用户对应的密码
API 代码 技术详情页面展示的 API Code,按接入流程要求提供
IP 白名单 分别添加 120.76.228.68 和 47.115.74.60,两条都启用

eMAG API 使用用户名和密码进行 Basic Auth 认证;API 代码不能替代用户名或密码。API 用户还须具备 API 权限,访问来源 IP 也须在白名单内,具体要求见 eMAG 官方 API 文档。

密码只在海云星指定的安全授权入口中填写。截图、工单或群聊中,用户名和 API 代码应打码,密码应完整隐藏。

4 添加服务器 IP 白名单

海云星需要添加以下两个公网 IP,分别创建两条白名单记录:

记录 IP 地址
第 1 条 120.76.228.68
第 2 条 47.115.74.60
  1. 在“技术详情”下方找到 卖家 IP(Seller IPs)。
  2. 点击 添加新的 IP 地址。
  3. 在弹窗的 IP 输入框中,填写 120.76.228.68。
  4. 将 状态 保持为 YES,表示启用。
  5. 点击弹窗内的“保存”。
  6. 再次点击 添加新的 IP 地址,填写 47.115.74.60,保持状态为 YES 后保存。

两个 IP 都需要添加,每条记录只填写一个 IP。 保留其他仍在使用的服务商白名单,避免影响已有连接。

保存后,检查“卖家 IP”列表:应同时出现 120.76.228.68 和 47.115.74.60,且两条记录的状态均为 有效。可刷新列表确认记录仍然存在;如果提示添加成功,关闭提示后再核对列表。

“有效”表示这条白名单记录已启用。还需要从实际服务器出口完成一次连接检查,才能确认该环境能够访问 API。

5 核验连接

平台侧配置完成后,通过海云星已开放的安全接入流程提交对应站点的连接资料,并由实施人员从已加入白名单的服务器出口发起只读检查,例如读取类目或商品报价数量。

检查通过应同时满足:认证与 IP 检查通过,接口返回业务成功。店铺还没有商品时,成功返回空列表或商品数量为 0 也可以是正常结果。

当前接入范围(2026 年 11 月 12 日):海云星 eMAG 接入仍处于联调阶段。本教程用于平台侧授权准备;ERP 店铺绑定入口及后续商品功能,以实际开放版本为准。

6 常见问题

遇到的问题 处理方式
提示 Invalid vendor ip 核对接口请求实际使用的公网出口是否已加入当前站点的白名单,并检查记录状态是否有效。电脑测试通过后,服务器仍需使用自己的出口 IP 配置。
提示 You are not allowed to use this API 核对站点、API 用户名和密码,并请店铺管理员或 eMAG 支持确认该用户的 API 权限。不能只凭这条提示认定为密码错误。
找不到“技术详情”或无法添加 IP 检查是否进入“我的账户 → 个人资料”,并使用有相应管理权限的账号;仍无法操作时联系店铺管理员或 eMAG 支持。
RO 站可连接,BG 或 HU 站失败 分别核对各站点的账号开通情况、用户权限、凭证和 IP 白名单。RO 配置成功不代表其他站点自动完成。
上方的回调 URL 应该怎么填 首次完成认证与只读连接检查时,无需自行编造回调地址。订单、运单、退货等回调,应在对应功能接入时使用海云星提供的正式地址配置。
修改密码或服务器出口后无法连接 密码变更后通过安全入口更新连接凭证;出口变化时先配置新的白名单,再核验连接。

需要协助时,提供所选站点、操作步骤、错误提示和发生时间即可。附图前请遮盖店铺名称、用户名、API 代码、密码、实际 IP,以及页面中的其他个人或业务敏感信息。

完成后如何核对

0 / 3 已核对

按实际操作结果逐项确认。

按 Esc 或点击图片外侧关闭

这篇文档解决了你的问题吗?

你的选择会保存在当前浏览器。

文档目录
↑ ↓ 选择Enter 打开指南Esc 关闭