订单列表

简介

本接口用于查询订单列表。下单时间和结束时间二者必传一个，范围一个月

服务提供方

享道

接口URL

/openapi/order/liststd

请求方式

GET

请求频次

单次

请求参数

参数名称	类型	必选	说明
timestamp	long	是	请求时间，Unix Timestamp单位毫秒
passengerMobile	string	是	乘客手机号
startDate	string	否	下单开始时间 yyyy-MM-dd HH:mm:ss
endDate	string	否	下单结束时间 yyyy-MM-dd HH:mm:ss
carUseTimeStartDate	string	否	用车开始时间 yyyy-MM-dd HH:mm:ss
carUseTimeEndDate	string	否	用车结束时间 yyyy-MM-dd HH:mm:ss
cityCode	string	否	城市编码，默认为出发地所在城市参见附录6
pageNo	int	是	页数
pageSize	int	是	分页数量

响应参数

参数名称	类型	必有	说明
errCode	int	是	服务响应状态，参见附录5
errMsg	string	是	服务响应状态说明，参见附录5
content	object	否
content.orders	list	是	订单列表
content.orders.order_id	string	是	享道订单号
content.orders.oid	string	是	外部订单号
content.orders.passengerMobile	string	是	乘客手机号
content.orders.cityCode	string	是	城市编码，默认为出发地所在城市city_code参见附录6
content.orders.orderTime	string	是	下单时间
content.orders.appointmentTime	string	是	预计用车时间
content.orders.originAddressShort	string	是	下单起点
content.orders.destinationAddressShort	string	是	下单终点
content.orders.ride_type	string	是	运力类型，参见附录1
content.total	int	是	总订单数
content.pageCount	int	是	总页数

请求示例

请求

curl --request POST \
  --url https://open-sit.saicmobility.com/merchant/v1/openapi/order/liststd \
  --header 'Content-Type: application/json' \
  --header 'X-MerchantId: dc_open_app_tQDegU5ZTHdS5JVF' \
  --header 'X-Sign: 100e0ee4b79cecb5eee5d8f9f6665f49ebea13be' \
  --header 'X-SignAlgorithm: 1' \
  --header 'X-Timestamp: 20240712151428' \
  --data-raw '{"timestamp":1720768468150,"passengerMobile":"15900000001","startDate":"2024-07-01 00:00:00","endDate":"2024-07-12 23:59:59","carUseTimeStartDate":"","carUseTimeEndDate":"","cityCode":"021","pageNo":1,"pageSize":100}'

响应

{
  "errCode": 10000,
  "errMsg": "successful",
  "content": {
    "total": 1,
    "pageCount": 1,
    "orders": [
      {
        "passengerMobile": "15900000001",
        "orderTime": "2024-07-03 16:47:37",
        "appointmentTime": "2024-07-03 16:47:37",
        "cityCode": "021",
        "oid": "sQNbpB2meEcYBMXC4Atj2JKKyZm6Gmxt",
        "order_id": "T55q76n9w10fdf8e574c504957bf0af2fd6ce65301",
        "originAddressShort": "尚发大厦",
        "destinationAddressShort": "香樟花园",
        "ride_type": "compact"
      }
    ],
    "tid": "janusmerchant-0abc8415-M28683735-433"
  }
}