易知课堂

Appearance

快速导航

查询订单列表 ​

调用方式 ​

POST https://app-api.yizhiknow.com/open-api/orderList/v2

请求头 ​

Content-Type:application/json

请求参数 ​

参数类型长度必填说明
access_tokenstring是凭证，非body参数
pageint否页码
page_sizeint否每页返回条数，最大支持100，默认20
typeint是1付款订单
platformstring否默认全部平台 kt抖音课堂 kskt快手课堂 wxkt微信课堂
out_trade_nostring否内部订单号
trade_nostring否支付单号
phonestring否手机号
pay_time_startstring否支付时间开始时间：2022-07-14 00:00:00
pay_time_endstring否支付时间结束时间：2022-07-15 00:00:00
spread_idint否推广号id

日期查询说明 ​

  • 日期字段查询必须同时存在或消失，结束日期必须晚于开始日期，且跨度不能超过31天

请求参数示例 ​

json
{
  "page": 1,
  "page_size": 20,
  "type": 1,
  "pay_time_start": "2022-07-14 00:00:00",
  "pay_time_end": "2022-07-15 00:00:00",
  "platform":"kt",
  "out_trade_no": "40443537063313111111",
  "trade_no": "2022071222001448281459111111",
  "phone": "13011111111",
  "spread_id": 1
}

返回参数 ​

参数类型长度必填说明
codeint是错误码，参考
msgstring是错误描述
dataobject是返回内容

data ​

参数类型长度必填说明
current_pageint是当前页码
per_pageint是每页条数
totalint是总数
data[object]是业务数据

data 业务数据 ​

参数类型长度必填说明
platformstring是订单平台类型 kt：抖音课堂 kskt：快手课堂 wxkt：微信课堂
infoobject是订单数据
curriculumobject是课程数据
userobject是下单用户数据
specobject否规格数据 （存在时返回）
addressobject否地址数据 （存在时返回）
pay_timestring是支付时间：2022-08-26 18:24:50
pay_amountstring是下单金额
profitstring是收益金额："9.01"
source_typestring是订单来源，比如：直播间
spread_idint是推广号id

info 订单数据 ​

参数类型长度必填说明
out_trade_nostring是内部订单号
trade_nostring是支付单号

curriculum 课程数据 ​

参数类型长度必填说明
curriculum_idint是课程id
titlestring是课程名称
second_categoryint是二级类目
curriculum_codestring否课程编码

user 下单用户数据 ​

参数类型长度必填说明
user_idint是用户id
nicknamestring是用户名称
phonestring是手机号

spec 订单规格数据 ​

参数类型长度必填说明
spec_idint否规格id
spec_namestring否规格名称
spec_codestring否规格编码

address 订单地址数据 ​

参数类型长度必填说明
address_idint否地址id
receive_namestring否收件人姓名
receive_phonestring否收件人手机
receive_addressstring否收件地址
address_detailstring否详细地址

返回参数示例 ​

json
{
    "code": 200,
    "msg": "成功！",
    "data": {
        "current_page": 1,
        "per_page": 20,
        "total": 1,
        "data": [
            {
                "pay_amount": "38.80",
                "spread_id": 4257,
                "pay_time": "2023-02-20 18:14:03",
                "info": {
                    "out_trade_no": "40486237371857408000",
                    "trade_no": "4348601087202302200782184606"
                },
                "source_type": "其它",
                "profit": "34.92",
                "user": {
                    "user_id": 25,
                    "nickname": "榕",
                    "phone": "13631443335"
                },
                "curriculum": {
                    "curriculum_id": 27275,
                    "title": "科一二三四技巧课程456",
                    "second_category": 70500,
                    "curriculum_code": "ABC1234567890"
                },
                "spec": {
                    "spec_id": 3,
                    "spec_name": "测试规格27275",
                    "spec_code": "DEF9876543210"
                },
                "address": {
                    "address_id": 17180,
                    "receive_name": "测试姓名",
                    "receive_phone": "13423987752",
                    "receive_address": "北京-北京市-东城区",
                    "address_detail": "测试详细地址"
                },
                "platform": "kt"
            }
        ]
    }
}

错误码 ​

错误码描述
200成功
98710101无效 AccessToken
98710102缺少凭证
98710103凭证无效或过期
98710406日期跨度超出限制