Skip to main content

鉴权绑定直播账号

基本信息

接口名称:鉴权绑定直播账号状  态:已完成
接口路径:POST /paas/micro/live/authBindingLiveAccount更新时间:2023-05-04 18:35:55
Mock地址:https://apimock.e-buychina.com/mock/671/paas/micro/live/authBindingLiveAccount

请求参数

Headers:

参数名称参数值是否必填
Content-Typeapplication/json

Body:

参数名称类型必填默认值备注其他信息
uuidstring请求序列号最大长度:50
最小长度:1
Mock:@now('yyyyMMdd')-@string('lower',32)
appIdstring请求AppId最大长度:50
最小长度:1
Mock:@natural
actionstring交易类型最大长度:50
最小长度:1
Mock:authBindingLiveAccount
timestampnumber请求时间戳Mock:@timestamp
signTypestring签名类型最大长度:20
最小长度:1
Mock:sha256
signstring签名值最大长度:500
最小长度:1
Mock:@natural
langstring语言最大长度:50
最小长度:1
Mock:zh_CN
contentobject请求报文
  thirdAppIdstring直播应用ID(报备后由易百分配)最大长度:64
最小长度:1
Mock:@string
  apiNamestring鉴权提供API(非必填,通常由易百PAAS后管配置)最大长度:64
Mock:@string
  authCodestring鉴权平台授权码(C端调用三方或渠道SDK接口获取)最大长度:128
最小长度:1
Mock:@string

返回数据

参数名称类型必填默认值备注其他信息
uuidstring请求序列号最大长度:50
最小长度:1
Mock:@now('yyyyMMdd')-@string('lower',32)
successboolean交易成功与否Mock:@boolean
actionstring交易类型最大长度:50
最小长度:1
Mock:authBindingLiveAccount
timestampnumber返回时间戳Mock:@timestamp
errorCodestring错误码最大长度:50
Mock:@word
errorMessagestring错误描述最大长度:50
Mock:@csentence
signTypestring签名类型最大长度:20
Mock:sha256
signstring签名值最大长度:500
Mock:@natural
contentobject返回报文
  thirdOpenIdstring三方开放平台中的用户唯一ID(例如钉钉unionId、微信unionId)最大长度:50
Mock:@string
  thirdOpenTypestring鉴权平台类型(默认使用paas-api-xxx平台作填充)最大长度:50
Mock:@string
  thirdSubIdstring三方平台子账号(可由api层自行组装,仅作记录使用)最大长度:50
Mock:@string
  nickNamestring授权用户昵称最大长度:50
Mock:@string
  avatarstring授权用户头像最大长度:50
Mock:@string
  thirdAuthInfoobject第三方其他授权结果(返回详见备注)

备注

租户维度提供外部系统鉴权,获取外部系统用户唯一标识 自动绑定(创建)直播账号
接口场景描述:
1)外部系统具备单点鉴权接口能力,可协商易百对接其接口后,直接在易百PAAS后管配置外部鉴权流程实现(如银行客户、KA商户的云平台用户鉴权对接);
2)仅使用易百鉴权渠道(如微信小程序),三方需先申请渠道资质应用(可由易百代运营),通过三方授权易百方式进行用户鉴权;

鉴权流程如下图(以微信小程序鉴权为例):
image.png

请求报文示例:

{
  "uuid": "20230322-epdqeiswrdoonjglihrcvgceegxdrgpg",
  "appId": "ebuydev100100100",
  "action": "authBindingLiveAccount",
  "timestamp": 1679465316,
  "content": {
    "thirdAppId": "1400797116",
    "apiName": "wechat",
    "authCode": "......"
  },
  "signType": "sha256",
  "sign": "650890459174880",
  "lang": "zh_CN"
}

响应报文示例:

{
  "uuid": "20230322-epdqeiswrdoonjglihrcvgceegxdrgpg",
  "action": "authBindingLiveAccount",
  "content": {
    "thirdOpenType": "paas-api-wechat",
    "thirdOpenId": "TWEXFYY3"
  },
  "success": true,
  "errorCode": "",
  "errorMessage": "",
  "timestamp": 1679469170890,
  "signType": "sha256",
  "sign": "c138ad695eb86e6a8915db7760acb3a29794b1cda671292563a5d55ed9045eaa"
}

变更历史

变更日期变更内容
2023-05-04
2023-05-04
2023-03-22
2023-03-22
2023-03-22
2023-03-22
2023-03-22
2023-03-22
2023-03-22
2023-03-22
2023-03-22
2023-03-22
2023-03-22
2023-03-22
2023-03-15
2023-03-15
api-id=35821