基础 qianmi.elife.train.orders.list(查询火车票订单列表)

查询火车票订单列表,分页返回
 公共参数
请求地址:
环境 HTTP请求地址 HTTPS请求地址
正式环境 http://api.bm001.com/api https://api.bm001.com/api
系统级请求参数:
名称 类型 是否必须 描述
methodString 必须 API接口名称
access_tokenString 必须 接入码,获取方式:登录直销商系统(sale.bm001.com),进入“数据中心” > “开发工具”。
vString 必须 API协议版本,当前可选值:1.1
signString 必须 API输入参数签名结果
timestampString 必须 请求时间戳,时区为GMT+8(北京时间),格式:"yyyy-MM-dd HH:mm:ss",例如"2012-12-20 10:20:35",开放平台允许客户端请求的最大时间误差为10分钟
 业务参数
名称 类型 是否必须 示例值 默认值 描述
tradeNoString 可选 T12255655544 订单主单号
startTimeString 必须 2014-12-01 00:00:00当前日期三个月之前 订单开始时间
endTimeString 必须 2015-12-27 13:54:48当前日期 订单结束时间
sortString 可选 ascdesc 按订单生成时间排序标志,默认降序 格式: asc-升序,desc-降序
supUserIdString 可选 S010402 供货商编号
pageNoString 可选 00 当前页码 从0开始
pageSizeString 可选 1010 每页显示条数,最大值100
orderStatusString 可选 1 订单状态: 0-预定中 1-待支付 2-已取消 3-出票中 4-已出票 5-出票失败
 请求示例
OpenClient client = new DefaultOpenClient(url, appKey, appSecret);
TrainOrdersListRequest req = new TrainOrdersListRequest();
req.setStartTime("2014-12-01 00:00:00");
req.setEndTime("2015-8-11 13:54:48");
TrainOrdersListResponse response = client.execute(req, accessToken);
$client = new OpenClient;
$client->appKey = appKey;
$client->appSecret = appSecret;
$req = new TrainOrdersListRequest;
$req->setStartTime("2014-12-01 00:00:00");
$req->setEndTime("2015-8-11 13:54:48");
$res = $client->execute($req, $accessToken);
IOpenClient client = new DefaultOpenClient(url, appKey, appSecret);
TrainOrdersListRequest req = new TrainOrdersListRequest();
req.StartTime = "2014-12-01 00:00:00";
req.EndTime = "2015-8-11 13:54:48";
TrainOrdersListResponse response = client.Execute(req, accessToken);
 响应参数
名称 类型 示例值 描述
ticketTrades TicketTrade[] 订单详情
pageNo Number 0 页码,从0开始
pageSize Number 10 单页返回的记录数,默认10
totolCount Number 100 总记录数
 响应示例

JSON数据格式:

 异常示例

JSON数据格式:

 {
    "errorToken": "@@$-ERROR_TOKEN$-@@",
    "code": "33",
    "message": "非法的参数",
    "solution": "请查看根据服务接口对参数格式的要求",
    "subErrors": [{
      "code": "isv.invalid-paramete:XXXX",
      "message": "参数XXXX无效,格式不对、非法值、越界等"
    }]
  }
 错误码
错误码 错误描述 解决方案
isv.qianmi-elife-train-orders-list-service-error:00051016查询订单失败查询订单失败
isv.qianmi-elife-train-orders-list-service-error:00039005结束日期不能早于开始日期结束日期不能早于开始日期
isv.qianmi-elife-train-orders-list-service-error:00039004开始日期需在当前日期之前3个月内开始日期需在当前日期之前3个月内
 FAQ