权限点是商家对应用进行授权的依据,每一个权限点关联了一个系列的 Open API。通过这些 Open API,应用可以访问或编辑商店的数据。
这篇文档列出了平台目前已有的权限点以及它关联的接口。你可以实际需要决定在商家安装或更新应用时向商家申请哪些权限。例如,一个应用在使用过程中需要查询商家的订单信息,那么在安装时,就需要向商家请求获得 read_orders 的权限。
商家授权后,SHOPLINE 会返回包含 权限点 信息的访问令牌,应用携带访问令牌进行请求时,只有符合 权限点 范围的接口能够成功返回。
AccessScope
note
需要注意,部分 AccessScope 需要开通特定业务后才能够使用,在未开通业务权限之前申请权限,将可能出现以下报错:the app has no qualification。
需要开通特定业务的 AccessScope 包括:
write_payment_gateways:需要开通支付应用业务read_subscription_contracts&write_subscription_contracts:需要开通订阅电商业务
write_customers
权限点描述: 编辑客户、客户地址、订单历史记录和客户组
相关接口: companyLocationAssignAddress
私有应用是否可用: 是
write_selling_plan_group
权限点描述: 编辑销售计划组
相关接口: 添加商品到销售计划组、从销售计划组移除商品、删除销售计划组、创建销售计划组、更新销售计划组
私有应用是否可用: 否
write_product_listings
权限点描述: 编辑商品列表
相关接口: 查询销售渠道中分类下的商品 ID 列表