基础 qianmi.elife.train.items.list(查询火车票标准商品列表)

查询火车票标准商品列表:
1.辅助接口,确认当前用户被允许使用该标准商品,获取标准商品编号用于货源确认或车票预订;
2.该商品相对稳定,如已经确认并获取过,可作缓存;
3.如返回为空,请联系上级确认火车票商品对接状态以避免下单失败。
 公共参数
请求地址:
环境 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分钟
 业务参数
名称 类型 是否必须 示例值 默认值 描述
pageNoNumber 可选 00 页码 从0开始
itemNameString 可选 标准商品名称,支持不带特殊字符的模糊匹配
itemIdString 可选 1616554 标准商品编号
pageSizeNumber 可选 1010 单页返回的记录数
 请求示例
OpenClient client = new DefaultOpenClient(url, appKey, appSecret);
TrainItemsListRequest req = new TrainItemsListRequest();
TrainItemsListResponse response = client.execute(req, accessToken);
$client = new OpenClient;
$client->appKey = appKey;
$client->appSecret = appSecret;
$req = new TrainItemsListRequest;
$res = $client->execute($req, $accessToken);
IOpenClient client = new DefaultOpenClient(url, appKey, appSecret);
TrainItemsListRequest req = new TrainItemsListRequest();
TrainItemsListResponse response = client.Execute(req, accessToken);
 响应参数
名称 类型 示例值 描述
totalCount Number 100 总记录数
items AdminItem[] 可选择的火车票标准商品信息
pageNo Number 0 页码 从0开始
pageSize Number 10 单页返回的记录数
 响应示例

JSON数据格式:

 异常示例

JSON数据格式:

 {
    "errorToken": "@@$-ERROR_TOKEN$-@@",
    "code": "33",
    "message": "非法的参数",
    "solution": "请查看根据服务接口对参数格式的要求",
    "subErrors": [{
      "code": "isv.invalid-paramete:XXXX",
      "message": "参数XXXX无效,格式不对、非法值、越界等"
    }]
  }
 错误码
错误码 错误描述 解决方案
isv.qianmi-elife-train-items-list-service-error:00050303查询火车票商品列表失败联系平台支持,确认系统是否正常
 FAQ