文档中心 > API类目 > 阿里体育场馆服务API

qimen.alibaba.alisports.gymnasium.cards.listbyuser.get (用户会员卡列表)

获取用户所有的会员卡(含一卡通和专项卡)

公共参数

请求地址：

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

请求参数

名称	类型	是否必须	示例值	描述
aliuid	String	必须	eNfJ65ajfMoOw0_X9g	阿里体育用户id
center_id	String	可选	3456	中心id
stadium_id	String	可选	1234	场馆id
card_status	Number	可选	0	会员卡状态 0全部 1有效 2失效

响应参数

名称	类型	示例值	描述
is_success	Boolean	true	接口状态成功true 失败false
msg_code	String	SUCCESS	接口错误码成功时须返回SUCCESS
msg_info	String	success	接口错误详细信息
model	Model []		接口数据
└ balance Number 10 余额根据unit确定具体数据 └ card_status Number 1 会员卡状态 1正常 2失效 └ card_type Number 1 会员卡类型 1一卡通 2期间卡 3次卡 4余额卡 └ center_name String 杨浦体育活动中心中心名称 └ card_no String 310114030003 会员卡号 └ activated_at String 2017-09-09 09:09:09 开卡时间 └ expired_at String 2019-09-09 09:09:09 过期时间 └ center_id String 11 中心id └ card_id String 11 会员卡id └ sell_at String 2017-09-09 09:09:09 售卖时间 └ card_name String 一卡通会员卡名称 specials Specials [] 专项卡列表 └ sports String 游泳运动项目 └ card_no String 310114030003 会员卡号 └ card_id String 11 会员卡id └ card_name String 一卡通会员卡名称 └ sell_at String 2017-09-09 09:09:09 售卖时间 └ balance Number 10 余额根据unit确定具体数据 └ card_status Number 1 会员卡状态 1正常 2失效 └ center_name String 杨浦体育活动中心中心名称 └ card_type Number 1 会员卡类型 1一卡通 2期间卡 3次卡 4余额卡 └ activated_at String 2017-09-09 09:09:09 开卡时间 └ center_id String 11 中心id └ expired_at String 2019-09-09 09:09:09 过期时间 └ cardStatusDetail Number 10 卡详细状态 10 -使用中 20 - 已用完 30 - 已过期 40 - 已退卡 50 - 已冻结 60 - 未激活 └ autoActivateTime String 2017-09-09 自动激活时间

请求示例

{"card_status":0,"center_id":"3456","aliuid":"eNfJ65ajfMoOw0_X9g","stadium_id":"1234"}

响应示例

{
    "is_success":true,
    "msg_code":"SUCCESS",
    "msg_info":"success",
    "model":[
        {
                "balance":10,
                "card_status":1,
                "card_type":1,
                "center_name":"杨浦体育活动中心",
                "card_no":"310114030003",
                "activated_at":"2017-09-09 09:09:09",
                "expired_at":"2019-09-09 09:09:09",
                "center_id":"11",
                "card_id":"11",
                "sell_at":"2017-09-09 09:09:09",
                "card_name":"一卡通",
                "specials":[
                    {
                            "sports":"游泳",
                            "card_no":"310114030003",
                            "card_id":"11",
                            "card_name":"一卡通",
                            "sell_at":"2017-09-09 09:09:09",
                            "balance":10,
                            "card_status":1,
                            "center_name":"杨浦体育活动中心",
                            "card_type":1,
                            "activated_at":"2017-09-09 09:09:09",
                            "center_id":"11",
                            "expired_at":"2019-09-09 09:09:09"
                    }
                ],
                "cardStatusDetail":10,
                "autoActivateTime":"2017-09-09"
        }
    ]
}

验签示例

{"msg_code":"sign-check-failure","msg_info":"Illegal request"}

错误码解释

错误码	错误描述	解决方案

API工具

错误码查询工具 SDK下载

FAQ

有用( 0 ) 我要提问

返回
顶部

开放平台

阿里体育场馆服务API

qimen.alibaba.alisports.gymnasium.cards.listbyuser.get (用户会员卡列表)

公共参数

请求参数

响应参数

请求示例

响应示例

验签示例

错误码解释

API工具

FAQ