API调用授权(客户)
客户账号调用API需要经过授权,可通过用户中心统一身份认证修改权限进行授权。接口对应的权限项如下表,只要有其中一条权限项为无权限即不可调用。
- 未在表里的接口不需要做细粒度权限校验,客户账号均可调用。
- 不支持系统角色权限鉴权,仅支持策略鉴权。配置指导请参考:创建用户组并授权
- bss:discount:view权限码只影响响应中折扣信息返回,不影响接口调用,当无权限时,接口可正常访问,但不返回折扣信息。
- 官网参考资料链接:
场景 |
子场景 |
接口名称 |
接口URL |
权限码 |
权限项名称 |
---|---|---|---|---|---|
管理产品 |
查询商品价格 |
查询按需产品价格 |
POST /v2/bills/ratings/on-demand-resources |
bss:discount:view |
查看折扣、价格信息。 |
查询包年/包月产品价格 |
POST /v2/bills/ratings/period-resources/subscribe-rate |
bss:discount:view |
查看折扣、价格信息 |
||
查询包年/包月资源的续订金额 |
POST /v2/bills/ratings/period-resources/renew-rate |
bss:discount:view |
查看折扣、价格信息。 |
||
管理账户 |
管理账户 |
查询账户余额 |
GET/v2/accounts/customer-accounts/balances |
bss:balance:view |
查看账户信息。 |
管理交易 |
管理优惠券 |
查询优惠券列表 |
GET /v2/promotions/benefits/coupons |
bss:coupon:view |
查看优惠券、现金券、代金券。 |
管理包年/包月订单 |
查询订单列表 |
GET /v2/orders/customer-orders |
bss:order:view |
查看订单信息。 |
|
查询订单详情 |
GET /v2/orders/customer-orders/details/{order_id} |
bss:order:view |
查看订单信息。 |
||
取消待支付订单 |
PUT /v2/orders/customer-orders/cancel |
bss:order:update |
下单、取消订单、修改收货地址。 |
||
支付包周期订单 |
POST/v2/orders/customer-orders/pay |
bss:order:pay |
订单支付。 |
||
查询订单可用折扣 |
GET /v2/orders/customer-orders/order-discounts |
bss:discount:view |
查看折扣、价格信息。 |
||
支付包年/包月产品订单 |
POST /v3/orders/customer-orders/pay |
bss:order:pay |
订单支付。 |
||
查询退款订单的金额详情 |
GET /v2/orders/customer-orders/refund-orders |
bss:order:view |
查看订单信息。 |
||
管理包年/包月资源 |
查询客户包年/包月资源列表 |
POST /v2/orders/suscriptions/resources/query |
bss:order:view |
查看订单信息。 |
|
续订包年/包月资源 |
POST /v2/orders/subscriptions/resources/renew |
bss:renewal:update |
下单、取消订单、修改收货地址。 |
||
退订包年/包月资源 |
POST /v2/orders/subscriptions/resources/unsubscribe |
bss:order:update |
下单、取消订单、修改收货地址。 |
||
设置包年/包月资源自动续费 |
POST /v2/orders/subscriptions/resources/autorenew/** |
bss:renewal:update |
下单、取消订单、修改收货地址。 |
||
取消包年/包月资源自动续费 |
DELETE /v2/orders/subscriptions/resources/autorenew/{resource_id} |
bss:renewal:update |
下单、取消订单、修改收货地址。 |
||
设置或者取消包年/包月资源到期转按需 |
POST /v2/orders/subscriptions/resources/to-on-demand |
bss:renewal:update |
下单、取消订单、修改收货地址。 |
||
管理资源包 |
查询资源包列表V3 |
POST/v3/payments/free-resources/query |
bss:bill:view |
查看账单、月度成本、用量明细、成本管理、收支以及总览页面的费用走势。 |
|
查询资源包使用明细 |
GET /v2/bills/customer-bills/free-resources-usage-records |
bss:billDetail:view |
查看消费明细、资源消费、账单分析、付款历史记录。 |
||
查询资源包使用量 |
POST /v2/payments/free-resources/usages/details/query |
bss:bill:view |
查看账单、月度成本、用量明细、成本管理、收支以及总览页面的费用走势。 |
||
管理账单 |
管理账单 |
查询资源详单 |
POST /v2/bills/customer-bills/res-records/query |
bss:billDetail:view |
查看消费明细、资源消费、账单分析、付款历史记录。 |
查询汇总账单 |
GET /v1.0/{domain_id}/customer/account-mgr/bill/monthly-sum |
bss:bill:view |
查看账单、月度成本、用量明细、成本管理、收支以及总览页面的费用走势。 |
||
查询资源消费记录 |
GET /v2/bills/customer-bills/res-fee-records |
bss:bill:view |
查看账单、月度成本、用量明细、成本管理、收支以及总览页面的费用走势。 |
||
管理成本 |
管理成本 |
查询成本数据 |
POST /v4/costs/cost-analysed-bills/query |
bss:costanalysis:view |
查看成本分析。 |
管理企业 |
管理企业项目 |
开通客户企业项目权限 |
POST /v2/enterprises/enterprise-projects/authority |
bss:enterpriseProjectFunction:update |
开通企业项目功能。 |
管理发票 |
管理发票 |
查询发票列表 |
GET /v1.0/{domain_id}/payments/intl-invoices |
bss:invoice:update |
申请发票、查看信息。 |