文档中心 > API类目 > 闲鱼彩票

qimen.alibaba.idle.lottery.ticket.redeem (闲鱼彩票兑换)

闲鱼对接三方彩票代理商，兑换彩票体验券使用

公共参数

请求地址：

环境	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输入参数签名结果，签名算法介绍请点击这里。

请求参数

名称	类型	是否必须	示例值	描述
appId	String	必须	xxx	调用方appId 由开发人员提供
redeemTimestamp	String	必须	1706088790472	兑换请求时间戳 Unix时间戳（1688607524837）毫秒 System.currentTimeMillis
data	String	必须	xxx	业务数据加密后的数据
area	String	可选	hubei	兑换区域

响应参数

名称	类型	示例值	描述
success	Boolean	true	是否成功
errCode	String	SYS_ERR	返回码
errMessage	String	成功	错误消息返回消息
result	Result		result
└ orderTime String 1706088790472 兑换时间 └ tradeStatus String 1 兑换状态 0:创建 1:处理中 2:发码成功 3:发码失败 0、1说明还在处理中 └ outUserId String 123 调用方用户id 闲鱼userid └ tradeNo String xxx 订单号 └ encryptedTradeNo String xxx 加密后的订单号

请求示例

{"area":"hubei","data":"xxx","appId":"xxx","redeemTimestamp":"1706088790472"}

响应示例

{
    "success":true,
    "errCode":"SYS_ERR",
    "errMessage":"成功",
    "result":{
        "orderTime":"1706088790472",
        "tradeStatus":"1",
        "outUserId":"123",
        "tradeNo":"xxx",
        "encryptedTradeNo":"xxx"
    }
}

验签示例

{"success":"false","errCode":"sign-check-failure","errMessage":"Illegal request"}

错误码解释

错误码	错误描述	解决方案

API工具

错误码查询工具 SDK下载

FAQ

有用( 0 ) 我要提问

返回
顶部

开放平台

闲鱼彩票

qimen.alibaba.idle.lottery.ticket.redeem (闲鱼彩票兑换)

公共参数

请求参数

响应参数

请求示例

响应示例

验签示例

错误码解释

API工具

FAQ