文档中心 > API类目 > 淘宝直播API

qimen.taobao.live.game.event.data.push (淘宝直播游戏事件数据推送)

淘宝直播游戏推送互动、资金数据至三方游戏厂商侧接口

公共参数

请求地址：

环境	HTTP请求地址
正式环境	http://qimen.api.taobao.com/router/qm
测试环境	http://qimen.api.taobao.com/router/qmtest

公共请求参数：

名称	类型	是否必须	描述
method	String	是	API接口名称。
app_key	String	是	TOP分配给应用的AppKey。
session	String	否	用户登录授权成功后，TOP颁发给应用的授权信息，详细介绍请点击这里。当此API的标签上注明：“需要授权”，则此参数必传；“不需要授权”，则此参数不需要传；“可选授权”，则此参数为可选。
timestamp	String	是	时间戳，格式为yyyy-MM-dd HH:mm:ss，时区为GMT+8，例如：2015-01-01 12:00:00。淘宝API服务端允许客户端请求最大时间误差为10分钟。
format	String	否	响应格式。默认为xml格式，可选值：xml，json。
v	String	是	API协议版本，可选值：2.0。
customerId	String	是	WMS颁发给用户的ID
sign_method	String	是	签名的摘要算法，md5。
sign	String	是	API输入参数签名结果，签名算法介绍请点击这里。

请求参数

名称	类型	是否必须	示例值	描述
userInfo	UserInfo	可选		发生行为的用户信息
└ headImg String 可选 https://img.alicdn.com/sns_logo/i1/2215106399927/O1CN01AxY74B2NCcbiYnmRO_!!2215106399927-0-tblive.jpg 用户头像 └ userNick String 可选用户昵称用户昵称 └ userId String 可选 40a158fd-9b9c-4029-a98f-83ba7b1b49d2 用户 ID
liveInfo	LiveInfo	可选		发生行为的直播信息
└ title String 可选直播标题直播标题 └ liveId String 可选 195540e7-d36f-4af2-b096-3e5edb359838 直播 ID
dataType	String	可选	reward	推送数据类型
anchorInfo	AnchorInfo	可选		发生行为的主播信息
└ anchorNick String 可选主播昵称主播昵称 └ anchorId String 可选 c56f6318-afd3-499d-81bc-158359dfdd00 主播 ID └ anchorHeadImg String 可选 https://img.alicdn.com/sns_logo/i1/2215106399927/O1CN01AxY74B2NCcbiYnmRO_!!2215106399927-0-tblive.jpg 主播头像
bizInfo	BizInfo	可选		发生行为的业务信息
└ bizType String 可选 1 业务类型 └ data String 可选这是一条评论业务详细信息 └ fundAmount Number 可选 100 业务如果是资金类型会有本字段，代表涉及资金金额（分） └ bizId String 可选 ee9585fe-9f4f-4483-9e50-dc3b8fa5a527 业务 ID └ timestamp Number 可选 1697440871000 事件发生毫秒时间戳
appId	Number	可选	1234	游戏 ID

响应参数

名称	类型	示例值	描述
success	Boolean	true	是否成功
msgCode	String	SUCCESS	状态码
msgInfo	String	操作成功	描述信息

请求示例

{"userInfo":{"headImg":"https://img.alicdn.com/sns_logo/i1/2215106399927/O1CN01AxY74B2NCcbiYnmRO_!!2215106399927-0-tblive.jpg","userNick":"用户昵称","userId":"40a158fd-9b9c-4029-a98f-83ba7b1b49d2"},"liveInfo":{"title":"直播标题","liveId":"195540e7-d36f-4af2-b096-3e5edb359838"},"dataType":"reward","appId":1234,"anchorInfo":{"anchorNick":"主播昵称","anchorId":"c56f6318-afd3-499d-81bc-158359dfdd00","anchorHeadImg":"https://img.alicdn.com/sns_logo/i1/2215106399927/O1CN01AxY74B2NCcbiYnmRO_!!2215106399927-0-tblive.jpg"},"bizInfo":{"bizType":"1","data":"这是一条评论","fundAmount":100,"bizId":"ee9585fe-9f4f-4483-9e50-dc3b8fa5a527","timestamp":0}}

响应示例

{
    "success":true,
    "msgCode":"SUCCESS",
    "msgInfo":"操作成功"
}

验签示例

{"success":"false","msgInfo":"Illegal request","msgCode":"sign-check-failure"}

错误码解释

错误码	错误描述	解决方案

API工具

错误码查询工具 SDK下载

FAQ

有用( 0 ) 我要提问

返回
顶部

淘宝直播API

qimen.taobao.live.game.event.data.push (淘宝直播游戏事件数据推送)

公共参数

请求参数

响应参数

请求示例

响应示例

验签示例

错误码解释

API工具

FAQ

用户导航

用户反馈

用户反馈

用户反馈