文档首页/ 客户运营能力/ API参考/ API调用方式/ API调用授权(客户)
更新时间:2024-12-04 GMT+08:00

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

申请发票、查看信息。