wish API 相助方集成指南（开放效劳应用）
为了资助 Wish API 相助方集成职员更好地明确 Wish API 文档 ，，，，，，相识通过 API 可以执行哪些操作（相较于在 Wish 商户平台上直接操作）、哪些支持功效对构建 Wish 集成至关主要 ，，，，，，我们建设了以下指南 ，，，，，，以指导 API 相助方通过 API 建设开放效劳应用。。。。 。。。请按以下办法操作：
1. 在 Wish 沙盒情形中注册开放效劳应用：
1). 相助方通过 Wish 沙盒情形中的 ERP 注书页面注册 ERP ，，，，，，可以参阅 Wish API 文档。。。。 。。。
2). 相助方发送电子邮件至 Wish 相助方 API 邮箱 (partner-api@wish.com) ，，，，，，见告 Wish 您已注册 ERP ，，，，，，希望通过 API 会见 Wish 沙盒情形。。。。 。。。
3). Wish 将审批相助方的申请。。。。 。。。
4). 申请获得批准后 ，，，，，，相助方即可登录。。。。 。。。
5). 点击账户 > 建设应用。。。。 。。。
建设应用名称（使用您希望商户看到的名称）。。。。 。。。OAuth 要求提供重定向 URL（用于吸收授权 ，，，，，，您可以随时更改此 RUL）。。。。 。。。
请注重 ，，，，，，商户看不到沙盒中上一页的详细信息。。。。 。。。
6). 相助方将获得一个客户端 ID 和客户端密钥 ，，，，，，用于在 Wish 沙盒中举行商户账户测试（在沙盒中完成 Wish API OAuth 流程需要用到该客户端 ID 和客户端密钥）。。。。 。。。
2. 相助方可以用商户身份再次登录沙盒。。。。 。。。由于这是沙盒情形 ，，，，，，相助方不必输入真实的商户信息。。。。 。。。
1). 相助方使用新的电子邮件（差别于注册 ERP 时使用的电子邮件）登录 Wish ，，，，，，并以商户身份最先开发开放效劳应用。。。。 。。。
2). 将虚拟商户账号与 ERP 相助方关联。。。。 。。。
a). 在沙盒中以商户身份登录时 ，，，，，，商户应将 URL 更改为 https://sandbox.merchant.wish.com/v3/oauth/authorize?client_id={client_id} ，，，，，，其中 {client_id} 是商户建设开放效劳应用时由 ERP 天生的 client_id。。。。 。。。此时系统将显示提醒 ，，，，，，要求商户授权 ERP 全权会见商户店肆。。。。 。。。
b). 当商户授权后 ，，，，，，URL 将更改为 https://example.redirect.uri.com?code={authorization_code} ，，，，，，这是 ERP 建设开放效劳应用时指定重定向到的位置。。。。 。。。
c). 此时 ，，，，，，可以凭证典范的 OAuth 流程举行操作。。。。 。。。
d). 所有 API 请求都应包括 access_token。。。。 。。。会见令牌有用期为30天。。。。 。。。
e). 要获得新的会见令牌 ，，，，，，可以使用 refresh_token。。。。 。。。此操作将使前一个令牌失效。。。。 。。。
3). 相助方将在 Wish 沙盒情形中举行所有测试。。。。 。。。
4). 无需请求 Wish 特殊批准即可继续。。。。 。。。
3. 在 Wish 生产情形中注册开放效劳应用
1). 相助方通过 Wish 生产情形中的 ERP 注书页面在生产情形中注册 ERP。。。。 。。。
2). 相助方发送电子邮件至 Wish 相助方 API 邮箱 (partner-api@wish.com) ，，，，，，见告 Wish 您已注册 ERP ，，，，，，希望通过 API 会见 Wish 生产情形。。。。 。。。
3). Wish 将审批相助方的申请 ，，，，，，若发明问题 ，，，，，，则通知相助方。。。。 。。。
4). 获得批准后 ，，，，，，您可以登录账户并选择账户 > 建设应用。。。。 。。。
相助方输入要在 Wish 应用市肆宣布的信息。。。。 。。。“应用名称”和“重定向 URL”是必填字段。。。。 。。。相助方还可以输入附加信息 ，，，，，，例如应用徽标、价值主张、形貌、网站和/或客服邮箱 ，，，，，，这些信息需要经由审核 ，，，，，，由于这些信息将显示给商户。。。。 。。。
输入这些附加信息不影响开放效劳应用的建设和 API 集成 ，，，，，，但这些字段仅在获得批准后才会宣布到 Wish 应用市肆中。。。。 。。。同时 ，，，，，，可以按如下所示审查这些附加信息字段的批准状态。。。。 。。。
您可以前往账户 > 应用设置 ，，，，，，审查和编辑上面提交的所有信息（必填项或附加信息）。。。。 。。。若是编辑或删除了附加信息字段中的信息 ，，，，，，将需要重新举行审核。。。。 。。。
5). 参阅 Wish 生产情形 API 文档。。。。 。。。
6). 相助方完成 OAuth 流程。。。。 。。。
7). 相助方需要启动 Wish 生产情形集成 ，，，，，，并记得将 API 挪用指向 Wish 生产情形 ，，，，，，而不是沙盒情形。。。。 。。。
4. 商户必需在 Wish 商户平台上注册一个唯一的店肆账户 ，，，，，，并授权 ERP 向商户的 Wish 店肆发送数据并从其店肆吸收数据。。。。 。。。
1). 注册商户账户时 ，，，，，，商户需要提交验证营业执照和小我私家信息 ID 的信息 ，，，，，，这些信息将由 Wish 举行审批。。。。 。。。
2). 商户账户将由 Wish 客户司理代表举行审批。。。。 。。。
3). 然后商户需要通过以下方法之一授权 ERP:
a). 商户选择一个 ERP 并注册账户。。。。 。。。
(i) 若是商户在 ERP 界面上选择 Wish 授权链接 ，，，，，，则重定向到“OAuth 授权”页面 ，，，，，，在这里可以授权 ERP。。。。 。。。
? 链接应如下所示 ，，，，，，其中包括 ERP 的唯一生产客户端 ID：https://merchant.wish.com/v3/oauth/authorize?client_id={PRODUCTION_CLIENT_ID}
(ii) 若是商户点击“授权” ，，，，，，则重定向到 ERP 指定的“重定向 URI” ，，，，，，并提供一个授权码。。。。 。。。ERP 将使用该授权码挪用 Wish API 来获得会见令牌。。。。 。。。
b). 商户在 Wish 应用市肆中搜索 ERP（注重：此历程尚未启动 ，，，，，，可是 ERP 应该能够处置惩罚此历程 ，，，，，，为未来的启动做好准备）：
(i) 若是商户选择“添加应用” ，，，，，，则重定向到“OAuth 授权”页面 ，，，，，，商户可以在该页面授权 ERP。。。。 。。。
(ii) 若是商户点击“授权” ，，，，，，则重定向到 ERP 指定的“重定向 URI” ，，，，，，并提供一个授权码。。。。 。。。ERP 将使用此授权码挪用 Wish API 来获得会见令牌。。。。 。。。
? 若是 ERP 指定的“重定向 URI”页面无法处置惩罚商户未登录和/或没有 ERP 账户的情形 ，，，，，，则说明毗连可能未完成。。。。 。。。
? 要完成毗连 ，，，，，，请提醒商户登录或注册 ERP。。。。 。。。然后将授权码添加到 URL 中 ，，，，，，并在商户登录或建设账户后完成 OAuth 流程。。。。 。。。
c). 至此即完成授权历程。。。。 。。。
d). 若是商户想要作废 ERP 授权 ，，，，，，可以随时通过 Wish 商户平台上的“账户”>“设置”>“API 设置”作废授权。。。。 。。。
请注重 ，，，，，，为了提高开放服用应用的清静性 ，，，，，，相助方现在最多可为开放效劳应用添加2个 OAuth 客户端密钥。。。。 。。。只需前往“应用设置”页面 ，，，，，，然后点击第一个客户端密钥下面的“添加第二个密钥”即可添加第二个：
若是客户端密钥已经泄露 ，，，，，，相助方还可以凭证需要通过删除旧密钥并添加新密钥来更改2个客户端密钥。。。。 。。。
注重：要查找文档、提醒、教程等链接 ，，，，，，请前往 Wish 开发职员页面。。。。 。。。
文章内容泉源：wish商户官方网站