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

API调用授权(伙伴)

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

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

表1

场景

子场景

接口名称

接口URL

权限项

权限项名称

管理产品

查询产品信息

查询产品的折扣和激励策略

GET /v2/products/incentive-discount-policies

BPC_ITEM_SALES_040100

销售-激励-产品激励策略-产品折扣与激励策略查看

管理客户

注册客户

校验客户注册信息

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/new-customers-tags/batch-query

BPC_ITEM_SUBCUSTSERV_010100

销售-云经销商-云经销商管理-我的二级分销商列表-查看历史客户经理

管理云经销商

查询云经销商

查询云经销商列表

POST /v2/partners/indirect-partners/query

BPC_ITEM_SALES_020100

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

管理云经销商账户

向云经销商账户拨款

POST /v2/accounts/partner-accounts/indirect-partner-adjust

BPC_ITEM_SALES_020104

销售-云经销商-云经销商管理-我的二级分销商列表-拨款

回收云经销商账户拨款

POST /v2/accounts/partner-accounts/indirect-partner-reclaim

BPC_ITEM_SALES_020105

销售-云经销商-云经销商管理-我的二级分销商列表-回收

管理云经销商优惠券

查询已发放的代金券额度

GET /v2/partners/issued-coupon-quotas

BPC_ITEM_SUBCUSTSERV_030600

销售-客户-券管理-已发放代金券-查询已发放列表

向云经销商发放代金券额度

POST /v2/partners/coupon-quotas/indirect-partner-adjust

BPC_ITEM_SALES_020106|BPC_ITEM_SUBCUSTSERV_030104

  • 销售-云经销商-云经销商管理-我的二级经销商列表-发放代金券额度
  • 销售-客户-券管理-代金券额度-发放额度

回收代金券额度

POST /v2/partners/coupon-quotas/indirect-partner-reclaim

BPC_ITEM_SUBCUSTSERV_030601|BPC_ITEM_SUBCUSTSERV_030602

  • 销售-客户-券管理-已发放代金券额度-批量回收代金券额度
  • 销售-客户-券管理-已发放代金券额度-回收代金券额度

查询代金券额度的发放回收记录

GET /v2/partners/coupon-quotas/records

BPC_ITEM_SUBCUSTSERV_030102

销售-客户-券管理-代金券额度-查看操作记录

管理交易

管理客户账户

向客户账户拨款

POST /v2/accounts/partner-accounts/adjust-amount

BPC_ITEM_SUBCUSTSERV_010103

销售-客户-客户管理-客户列表-拨款

查询客户账户余额

POST /v2/accounts/customer-accounts/balances/batch-query

BPC_ITEM_SUBCUSTSERV_010103|BPC_ITEM_SUBCUSTSERV_010104|BPC_ITEM_SUBCUSTSERV_010100

  • 销售-客户-客户管理-客户列表-拨款
  • 销售-客户-客户管理-客户列表-回收
  • 销售-客户-客户管理-客户列表-查看列表

回收客户账户余额

POST /v2/accounts/partner-accounts/reclaim

BPC_ITEM_SUBCUSTSERV_010104

销售-客户-客户管理-客户列表-回收

查询收支明细

GET /v2/accounts/partner-accounts/account-change-records

BPC_ITEM_FINANCE_030100

销售-账务-资金管理-收支明细-查看收支明细

查询调账记录

GET /v3/accounts/partner-accounts/adjust-records

BPC_ITEM_FINANCE_040100

销售-客户-客户管理-调账记录-查看调账记录

查询伙伴/云经销商账户余额

GET /v2/accounts/partner-accounts/balances

BPC_ITEM_VIEW_010100|BPC_ITEM_SUBCUSTSERV_010103|BPC_ITEM_SUBCUSTSERV_010104|BPC_ITEM_SALES_020104|BPC_ITEM_SALES_020105

  • 主页-账号
  • 销售-客户-客户管理-客户列表-拨款
  • 销售-客户-客户管理-客户列表-回收
  • 销售-云经销商-云经销商管理-我的二级分销商列表-拨款
  • 销售-云经销商-云经销商管理-我的二级分销商列表-回收

管理优惠券

查询优惠券列表

GET /v2/promotions/benefits/coupons

BPC_MENU_FINANCE_100100|BPC_ITEM_SUBCUSTSERV_050101

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

查询优惠券额度

POST /rest/cbc/openapi/v2/partners/coupon-quotas/query

BPC_ITEM_SUBCUSTSERV_030100

销售-客户-券管理-代金券额度-查看代金券列表

发放优惠券

POST /v2/promotions/benefits/partner-coupons

BPC_ITEM_SUBCUSTSERV_030102|BPC_ITEM_SUBCUSTSERV_030103

  • 销售-客户-券管理-代金券额度-发放代金券
  • 销售-客户-券管理-现金券额度-查看操作记录

回收优惠券

POST /v2/promotions/benefits/partner-coupons/reclaim

BPC_ITEM_SUBCUSTSERV_030201

销售-客户-券管理-已发放代金券-回收代金券

查询优惠券的发放回收记录

GET /v2/promotions/benefits/partner-coupons/records/query

BPC_ITEM_SUBCUSTSERV_030102

销售-客户-券管理-代金券额度-查看操作记录

管理包年/包月订单

查询订单列表

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/bills/partner-bills/subcustomer-bills/monthly-sum

BPC_ITEM_FINANCE_090100

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

管理客户消费

查询伙伴消费子客户列表

POST /v2/bills/subcustomer-bills/res-fee-records/sub-customers/query

BPC_ITEM_FINANCE_020100

销售-客户-客户消费-消费记录-查看列表

查询伙伴子客户消费记录

GET /v2/bills/subcustomer-bills/res-fee-records

BPC_ITEM_FINANCE_020101

销售-客户-客户消费-消费记录-查看详情

相关文档