阿里云市场（market）通道配置教程

网程聚合数据 2026-10-31 04:11 14 阅读通道教程

「阿里云市场」通道配置教程：在云市场订购 API 商品并获取 AppCode，到用户中心上游通道配置页填写保存，即可调用已订购的商品接口。含商品逐个订购与生效时间说明。

「阿里云市场」（`market`）通道用于调用阿里云云市场（API 市场）上第三方服务商提供的数据接口。本通道接口按用户维度隔离凭证，你需要在用户中心填入自己的 AppCode，接口才会以你的账号发起调用，并扣减你在云市场购买的套餐包用量。

本教程说明两部分内容：如何在云市场订购接口并获取 AppCode，以及如何在用户中心的 `/member/upstream/config` 页面完成通道配置。

## 一、通道说明

- **凭证维度**：通道级。在配置页保存一次 AppCode，本通道下的全部接口共用这一份凭证。
- **必填项**：只有 AppCode 一项是必填，AppKey 与 AppSecret 可留空。
- **调用模式**：全部为同步返回，不需要提交任务、轮询结果，也不涉及回调地址配置。
- **计费方式**：平台按次计费，单价见各接口文档页，**只有调用成功（返回 `code` 为 0）才扣平台点数，失败不扣**；云市场侧则按所购商品的套餐包扣减调用量，扣减规则以云市场计量为准，两边都要有余量。
- **重要前提**：凭证共用，但**商品要逐个订购**。同一个 AppCode 可以调用你账号下已购买的所有云市场 API 商品；没有订购过的商品，即使 AppCode 正确也会被网关拒绝。

## 二、订购接口商品并获取 AppCode

**第 1 步：订购需要的 API 商品。** 在云市场找到对应商品页，选择免费试用或付费套餐包完成订购。例如本通道的天气类接口对应商品：<https://market.aliyun.com/detail/cmapi00074002>，ICP 备案实时查询对应商品：<https://market.aliyun.com/apimarket/detail/cmapi00068710>。各接口文档页也给出了对应的上游商品链接。

**第 2 步：查看 AppCode。** 登录云市场控制台 <https://marketnext.console.aliyun.com/>，进入「我的服务」，找到已订购的商品，在详情中查看 AppCode（以及 AppKey、AppSecret）。

> 同一个阿里云账号下，所有已购买的云市场 API 商品**共用同一套 AppCode / AppKey / AppSecret**，任一密钥对都可以调用已购商品。因此本通道只需配置一次，之后新增订购的商品无需再改配置。

**第 3 步（仅 RAM 用户需要）：补齐授权。** 如果你用 RAM 子账号登录后看到 AppCode、AppKey、AppSecret 都是空的，需要主账号为该 RAM 用户授予两个系统策略：`AliyunMarketplaceFullAccess`（管理云市场）与 `AliyunApiGatewayFullAccess`（管理 API 网关），然后重新登录查看。

**第 4 步（按需）：重置密钥。** 如怀疑 AppCode 泄露或套餐包被盗刷，可到 API 网关控制台 <https://apigateway.console.aliyun.com/> →「应用管理」→ 点击应用名称进入应用详情 →「AppCode」页签 → 操作列点击**重置 AppCode**（可选系统生成或自定义）。重置后旧值立即失效，必须回到用户中心更新配置。

> 官方说明参考：<https://help.aliyun.com/zh/marketplace/user-guide/user-faqs>

> 安全提示：AppCode 等同于你调用云市场接口的身份凭证，泄露后他人可消耗你的套餐包用量。请勿写入前端代码、提交到版本库或公开分享；发现异常消耗时先重置 AppCode，再更新平台配置。

## 三、在用户中心配置通道

**第 1 步：登录用户中心。** 打开 <https://www.phpwc.cn/member/login>，用用户名或邮箱登录。

**第 2 步：进入上游通道配置页。** 直接访问 <https://www.phpwc.cn/member/upstream/config#tab-market>，页面会自动定位到「阿里云市场」选项卡；也可以从用户中心左侧菜单展开「上游通道」→ 点击「上游通道配置」，再手动点击上方的「阿里云市场」选项卡。手动切换选项卡时，网址会自动补上对应的 `#tab-` 锚点，可直接收藏或分享该链接。

> 如果带锚点的链接打开后仍停在第一个选项卡，通常是浏览器缓存了旧版页面，按 `Ctrl+Shift+R` 强制刷新一次即可。

**第 3 步：填写配置项。**

| 字段 | 是否必填 | 填写说明 |
|---|---|---|
| AppCode | 必填 | 云市场控制台「我的服务」中查看到的 AppCode，注意不要带空格或换行 |
| AppKey | 选填 | 与 AppSecret 配对，用于签名认证方式，一般留空即可 |
| AppSecret | 选填 | 同上，一般留空即可 |

> 关于两种认证方式：平台优先使用 AppCode 简单认证（请求头 `Authorization: APPCODE xxx`）；只有在没有 AppCode 时才会回退到 AppKey/AppSecret 的 HMAC-SHA256 签名认证。但配置页把 AppCode 设为必填，只填 AppKey/AppSecret 会提示「请填写 AppCode」而无法保存，因此**正常使用时填 AppCode 就够了**，另外两项留空。

**第 4 步：保存。** 点击**保存配置**，看到「配置已保存」提示即完成（提示约 3 秒后自动消失）。配置为覆盖式保存，之后更换 AppCode 重新提交一次即可；本页没有「删除/清空配置」按钮。

**第 5 步：生效时间。** 保存动作会立即清除凭证缓存，正常情况下即时生效。由于服务以多进程方式运行，个别情况下其他进程的缓存需要等待自动过期，最长约 10 分钟。

常见问题

Q：AppCode 在哪里获取？重置之后需要做什么？

A：登录云市场控制台，进入「我的服务」，找到已订购的商品，在详情中查看 AppCode（以及 AppKey、AppSecret）。如怀疑泄露或套餐包被盗刷，可到 API 网关控制台的应用详情「AppCode」页签重置，重置后旧值立即失效，必须回到用户中心覆盖保存新值。

Q：AppKey 和 AppSecret 要填吗？只填这两项能不能保存？

A：一般留空即可。平台优先使用 AppCode 简单认证，只有没有 AppCode 时才回退到 AppKey/AppSecret 签名认证；而配置页把 AppCode 设为必填，只填这两项会提示「请填写 AppCode」而无法保存，因此正常使用时填 AppCode 就够了。

Q：配置好之后新订购的商品还要再配一次吗？保存后多久生效？

A：不用再配。同一阿里云账号下所有已购买的云市场 API 商品共用一套 AppCode/AppKey/AppSecret，本通道只需配置一次；但每个接口对应的商品都必须先订购。保存后看到「配置已保存」即写入成功，凭证缓存立即清除、正常即时生效，个别服务进程最长约 10 分钟自动过期。

通道配置阿里云市场天气预报接口 API集成凭证配置

上一篇：阿里云短信（aliyunopen）通道配置教程下一篇：没有了

网友评论（0）

暂无评论，快来抢沙发～