淘宝开放平台 - 文档中心

请求地址：

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

名称	类型	是否必须	示例值	更多限制	描述
order_no	String	必须	2021060317475062199191693		saas订单号
user_id	String	可选	123		阿里体育用户id
query_detail_info	Boolean	可选	false	默认值：false	是否获取课程详细信息(关联学员，上课记录等)

名称	类型	示例值	描述
msg_code	String	SUCCESS	调用码
msg_info	String	调用成功	调用信息
model	CourseDetailResDTO		返回信息
└ courseType Number 2 课程类型 1 排课类 2 约课类 └ availableState Number 1 使用状态 1 未激活 2 已激活 3 已过期 4 已完成 └ consumeClassHours Number 10 已使用课时 └ enableQrCode Boolean true 课程二维码是否可用 └ totalClassHours Number 20 总课时 studentInfo StudentInfo 学生信息 └ studentId String 123 学生id └ studentBirthDay Number 1622541486000 学生生日(毫秒) └ studentGender Number 1 学生性别 1 男 2 女 └ phone String 13816661358 联系电话 └ studentName String 小明学生姓名 └ studentAvatar String https://aliyun.com/xxx 学生头像 └ urgencyContact String 明哥紧急联系人 courseStudentClassRecord CourseStudentClassRecord [] 上课记录 └ classRecordId String 1 上课记录id └ classHours Number 1 消耗课时 └ classStatus Number 1 课时状态 1 旷课 2 完课 3 请假 └ classTime Number 1622541486000 上课时间(毫秒) └ courseCode String 3121s112 课程二维码 └ latitude String 35.255 纬度 └ companyName String xx篮球馆商户名称 └ saasStadiumAddress String 上海市浦东新区xx路xxx号场馆地址 └ categoryName String 篮球体育类目名称 └ saasStadiumId String 1 saas场馆id └ userAgeRange String {"min":11,"max":22} 适用年龄 └ courseName String 篮球启蒙运动课程入门班课程名称 └ validityDesc String 未到有效期课程有效期说明(课程无具体开始/截止时间，返回有效期说明文案) └ courseImg String https://aliyun.com/xxx 课程图 └ stadiumPhone String 18888888888 场馆电话 └ courseId String 1 课程id └ saasStadiumName String xx篮球馆 saas场馆名称 └ longitude String 110.111 经度 └ extraInfo String {} 扩展信息 └ courseStartTime Number 1622541486000 课程开始时间(毫秒) └ courseEndTime Number 1622541486000 课程结束时间(毫秒)
is_success	Boolean	true	是否调用成功

{"order_no":"2021060317475062199191693","user_id":"123","query_detail_info":false}

{
    "msg_code":"SUCCESS",
    "msg_info":"调用成功",
    "model":{
        "courseType":2,
        "availableState":1,
        "consumeClassHours":10,
        "enableQrCode":true,
        "totalClassHours":20,
        "studentInfo":{
            "studentId":"123",
            "studentBirthDay":1622541486000,
            "studentGender":1,
            "phone":"13816661358",
            "studentName":"小明",
            "studentAvatar":"https:\/\/aliyun.com\/xxx",
            "urgencyContact":"明哥",
            "courseStudentClassRecord":[
                {
                        "classRecordId":"1",
                        "classHours":1,
                        "classStatus":1,
                        "classTime":1622541486000
                }
            ]
        },
        "courseCode":"3121s112",
        "latitude":"35.255",
        "companyName":"xx篮球馆",
        "saasStadiumAddress":"上海市浦东新区xx路xxx号",
        "categoryName":"篮球",
        "saasStadiumId":"1",
        "userAgeRange":"{\"min\":11,\"max\":22}",
        "courseName":"篮球启蒙运动课程入门班",
        "validityDesc":"未到有效期",
        "courseImg":"https:\/\/aliyun.com\/xxx",
        "stadiumPhone":"18888888888",
        "courseId":"1",
        "saasStadiumName":"xx篮球馆",
        "longitude":"110.111",
        "extraInfo":"{}",
        "courseStartTime":1622541486000,
        "courseEndTime":1622541486000
    },
    "is_success":true
}

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

错误码	错误描述	解决方案

错误码查询工具 SDK下载

开放平台

阿里体育场馆服务API

qimen.alibaba.alisports.stadiums.train.course.detail (查询体培课程详情)

公共参数

请求参数

响应参数

请求示例

响应示例

验签示例

错误码解释

API工具

FAQ