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 打开技术详情页面
- 登录 eMAG 罗马尼亚站卖家后台。
- 核对右上角的店铺和站点。
- 依次进入 我的账户 → 个人资料 → 技术详情。
英文后台对应路径为 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 |
- 在“技术详情”下方找到 卖家 IP(Seller IPs)。
- 点击 添加新的 IP 地址。
- 在弹窗的 IP 输入框中,填写
120.76.228.68。 - 将 状态 保持为 YES,表示启用。
- 点击弹窗内的“保存”。
- 再次点击 添加新的 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,以及页面中的其他个人或业务敏感信息。