访问权限
使用 REST API 访问 Genstore 店铺数据之前,所有应用都必须声明所需的访问范围,包括通过命令行界面(CLI)预先设定的权限范围以及可能需要额外申请的特定数据访问权限。
如果您的应用已经通过 CLI 配置了访问范围,您将能在 API 访问权限 页面查看相关内容。然而,对于一些特殊数据,如 所有订单数据 和 保护字段数据,即使已声明相应的基本访问权限,您仍需通过合作伙伴平台提交额外的权限申请并获得审核批准,才能访问这些信息。
访问权限范围
访问范围 | 方式 | 描述 |
---|---|---|
业务域访问范围 | 应用声明指定 | 应用必须通过声明并在被授权后才能访问指定的业务域数据。默认情况下,订单数据仅包括最近 60 天的订单,且不包括任何保护字段。如需访问更早的订单数据或保护字段,需通过平台审核获得额外权限。 |
所有订单数据范围 | 申请审核通过 | 需要通过合作伙伴平台申请,审核通过后,可以访问包括 60 天之前的所有订单数据。 |
保护字段范围 | 申请审核通过 | 需要通过合作伙伴平台申请,审核通过后,可访问涉及隐私保护的字段数据。 |
申请访问所有订单数据
默认情况下,订单域的 REST APIs 只能获取最近 60 天的订单数据。如需访问更早的数据,必须申请并获得批准。
申请步骤
进入合作伙伴平台的应用控制台:
- 在左侧导航栏中,点击 应用。
- 选择目标应用,进入应用详情页。
- 在左侧导航中,点击 API 访问权限。
- 在 读取所有订单数据 区域,点击 申请访问权限 按钮。
- 在权限申请表单页,填写权限申请表单,说明申请理由,提交工单。
- 平台收到申请后,将会进行审核。
申请访问保护字段
为保护商家及其客户的隐私,访问以下保护字段需提交申请并通过平台审核:
- 姓名:是指姓名相关的字段,姓、名、全名
- 邮箱:用户的邮箱地址
- 手机:用户的手机号
- 地址:用户的地址
申请步骤
进入合作伙伴平台的应用控制台 :
- 在左侧导航栏中,点击 应用。
- 选择目标应用,进入应用详情页。
- 在左侧导航中,点击 API 访问权限。
- 在 受保护的客户数据 区域,点击 申请访问权限 按钮。
- 在权限申请表单页,填写权限申请表单,说明申请理由,提交工单。
- 平台收到申请后,将会进行审核。