文档首页/ 合作伙伴中心/ API参考/ API调用方式/ API调用授权(伙伴)
更新时间:2024-08-19 GMT+08:00

API调用授权(伙伴)

伙伴操作员账号调用API需要经过授权,可通过伙伴中心对操作员赋予有权限项的角色来进行授权,如何为角色授权请参见为组织人员分配权限。接口对应的权限项如下表,只要有权限项中的一条即可以调用。

未在表里的接口不需要做细粒度权限校验,操作员账号均可调用。

表1

场景

子场景

接口名称

接口URL

权限项

权限项名称

管理客户

注册客户

校验客户注册信息

POST /v2/partners/sub-customers/users/check-identity

BPC_ITEM_SUBCUSTSERV_010118

销售-客户-客户管理-客户列表-创建伙伴子客户(能力开放)

发送验证码

POST /v2/bases/verificationcode/send

BPC_ITEM_SUBCUSTSERV_010118

销售-客户-客户管理-客户列表-创建伙伴子客户(能力开放)

创建客户

POST /v2/partners/sub-customers

BPC_ITEM_SUBCUSTSERV_010118

销售-客户-客户管理-客户列表-创建伙伴子客户(能力开放)

实名认证

申请个人实名认证

POST /v2/customers/realname-auths/individual

BPC_ITEM_SUBCUSTSERV_010119

销售-客户-客户管理-客户列表-实名认证同步(能力开放)

申请企业实名认证

POST /v2/customers/realname-auths/enterprise

BPC_ITEM_SUBCUSTSERV_010119

销售-客户-客户管理-客户列表-实名认证同步(能力开放)

申请实名认证变更

PUT /v2/customers/realname-auths/enterprise

BPC_ITEM_SUBCUSTSERV_010119

销售-客户-客户管理-客户列表-实名认证同步(能力开放)

查询实名认证审核结果

GET /v2/customers/realname-auths/result

BPC_ITEM_SUBCUSTSERV_010119

销售-客户-客户管理-客户列表-实名认证同步(能力开放)

管理客户

查询客户列表

POST /v2/partners/sub-customers/query

BPC_ITEM_SUBCUSTSERV_010100|BPC_ITEM_SUBCUSTSERV_010500

  • 销售-客户-客户管理-客户列表-查看列表
  • 销售-客户-客户管理-二级经销商子客户-查看客户信息

冻结客户账号

POST /v2/partners/sub-customers/freeze

BPC_ITEM_SUBCUSTSERV_010501|BPC_ITEM_SUBCUSTSERV_010115

  • 销售-客户-客户管理-二级经销商子客户-冻结/解冻账号
  • 销售-客户-客户管理-客户列表-冻结/解冻账号

解冻客户账号

POST /v2/partners/sub-customers/unfreeze

BPC_ITEM_SUBCUSTSERV_010501|BPC_ITEM_SUBCUSTSERV_010115

  • 销售-客户-客户管理-二级经销商子客户-冻结/解冻账号
  • 销售-客户-客户管理-客户列表-冻结/解冻账号

管理云经销商

查询云经销商

查询云经销商列表

POST /v2/partners/indirect-partners/query

BPC_ITEM_SALES_020100

销售-云经销商-云经销商管理-我的二级分销商列表-查询二级分销商列表

管理授信

管理授信

查询消费余额

GET /v2/partners/credit/consumption-quota

BPC_ITEM_ACCOUNT_010500

伙伴信息-基本信息-消费配额-查看消费配额

管理交易

管理优惠券

查询优惠券列表

GET /v2/promotions/benefits/coupons

BPC_MENU_FINANCE_100100|BPC_ITEM_SUBCUSTSERV_050101

  • 销售-账务-券管理-代金券查看-代金券列表查看
  • 销售-客户-客户订单-订单支付-支付订单

管理包年/包月订单

查询订单列表

GET /v2/orders/customer-orders

BPC_ITEM_SUBCUSTSERV_060100|BPC_ITEM_SUBCUSTSERV_060200

  • 销售-客户-客户订单-客户订单-查看列表
  • 销售-客户-客户订单-二级经销商的客户-查看列表

查询订单详情

GET /v2/orders/customer-orders/details/{order_id}

BPC_ITEM_SUBCUSTSERV_060100|BPC_ITEM_SUBCUSTSERV_060200

  • 销售-客户-客户订单-客户订单-查看列表
  • 销售-客户-客户订单-二级经销商的客户订单-查看列表

管理按需资源

查询客户按需资源列表

POST /v2/partners/sub-customers/on-demand-resources/query

BPC_ITEM_SUBCUSTSERV_010105

销售-客户-客户管理-客户列表-查看客户资源

管理客户预算

查询客户预算

GET /v2/partners/sub-customers/budget

BPC_ITEM_SUBCUSTSERV_010111|BPC_ITEM_SUBCUSTSERV_010503

  • 销售-客户-客户管理-客户列表-调整信用额度
  • 销售-客户-客户管理-二级经销商子客户-设置月度预算

批量查询客户预算

POST /v2/partners/sub-customers/budget/query

BPC_ITEM_SUBCUSTSERV_010111|BPC_ITEM_SUBCUSTSERV_010503

  • 销售-客户-客户管理-客户列表-调整信用额度
  • 销售-客户-客户管理-二级经销商子客户-设置月度预算

设置客户预算

POST /v2/partners/sub-customers/budget

BPC_ITEM_SUBCUSTSERV_010111|BPC_ITEM_SUBCUSTSERV_010503

  • 销售-客户-客户管理-客户列表-调整信用额度
  • 销售-客户业务-客户管理-二级经销商子客户-设置月度预算

管理账单

-

查询客户月度消费账单

GET /v2/bills/partner-bills/postpaid-bill-summary

BPC_ITEM_FINANCE_090100

销售-账务-伙伴账单-伙伴账单-查看伙伴账单

管理发票

管理发票

查询发票列表

GET /v1.0/{domain_id}/payments/intl-invoices

BPC_ITEM_FINANCE_060100

销售-账务-发票管理-发票中心-查看发票申请记录