常见问题

2026-04-24 03:41

Q1: 客户端ID（Client ID）是什么？

万里汇使用 Client ID 来认证集成商。集成商发送 API 请求之前需要确认 Client ID 是否正确。联系万里汇技术支持团队以获得 Client ID。

万里汇要求发送 API 请求之前要加签，集成商接收到 API 请求后要验签。详见：生成签名及加验签。

首次登录开发者门户时，系统会显示 API 集成协议弹窗。该协议要求用户同意万里汇的 API 集成条款，只要勾选确认框即可继续使用开发者门户。

如果用户拒绝签署协议，系统会显示确认弹窗，用户可点击“取消”以返回协议弹窗。若用户再次确认拒绝，系统将退出登录，往后每次登录时仍会显示该协议弹窗，直至用户同意签署为止。用户只有接受协议后才能访问开发者门户功能。

开发者门户根据用户的权限角色进行不同的跳转。如果您仅拥有开发者（Developer）或开发者经理（Developer Manager）权限，系统会自动跳转到开发者门户首页。如果您同时拥有管理员（Admin）和开发者权限，则不会自动跳转到开发者门户。

开发者经理可以查看和管理开发者门户中的每个页面/功能/组件；管理沙盒配置、执行所有测试用例、提交上线请求给 WorldFirst SA 审批、管理生产配置（需要WorldFirst SA 进行实际配置更新）。

开发者可以提交删除应用、编辑应用、使应用下线等请求，但上线和生产配置需要开发者经理和 WorldFirst SA 的批准。

需要审批的操作包括：申请上线、删除应用、申请下线、编辑公钥、添加通知、编辑通知、删除通知。不同的操作类型需要提供相应的详细信息。

编辑公钥或 Webhook 时需要提供旧值（如旧的 webhook URL、旧的公钥、旧的事件等）和新值（如新的 webhook URL、新的公钥、新的事件）。这对于审核变更内容非常重要。

为了确保您获得更好的集成体验，万里汇开发者中心提供了以下几种测试工具：

更多关于测试工具的使用方法及说明，详见开发者中心的测试工具页面。

只有在完成所有必要的测试用例后，用户才能请求上线。您可选择填写集成原因说明，并点击提交。提交上线审核并经开发者经理审批后，万里汇 SA 团队将审查您的测试用例结果并于 4 - 5 个工作日内给出审核结果。

如果上线申请被拒，您需要查看万里汇 SA 团队的评论，了解拒绝原因，根据反馈解决未完成的问题，再重新提交上线申请。

上线批准后，您可以设置并管理生产环境密钥，以及添加、编辑或删除 Webhook 和 Webhook URL。不过，相关操作需要经过开发者经理的批准。

然而，您将无法在生产环境中添加、编辑或删除解决方案和模块。如果范围有变，需要更改模块配置，您可以创建新的应用。

用户只能删除状态为＂沙盒设置＂或＂测试中＂的应用。当应用状态为＂已提交上线请求＂或＂上线中＂时，将不允许删除。