dingtalk.oapi.alitrip.btrip.price.query (查询预估价)

查询预估价

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
req OpenApiIntervalPriceRq 必须 请求入参
  • └ corpid
  • String
  • 必须
  • corpid
  • 企业id
  • └ from_where
  • String
  • 必须
  • 杭州
  • 从哪里出发
  • └ userid
  • String
  • 必须
  • ding12345
  • 钉用户id
  • └ itinerary_id
  • String
  • 可选
  • 1245
  • 行程id
  • └ start_time
  • Date
  • 必须
  • 2020-11-11 00:00:00
  • 出发时间
  • └ end_time
  • Date
  • 必须
  • 2020-12-12 00:00:00
  • 返程时间
  • └ to_where
  • String
  • 必须
  • 上海
  • 目的地
  • └ category
  • String
  • 必须
  • flight
  • 类目flight\hotel\train
  • └ query_key
  • String
  • 可选
  • abc
  • 根据key查询

响应参数

名称 类型 示例值 描述
result Result {} 接口返回
  • └ success
  • Boolean
  • true
  • 是否成功
  • module
  • Module
  • 接口返回model
  • hotel_fee_detail
  • HotelFeeDetail []
  • {}
  • 酒店差标
  • └ criterion
  • Number
  • 30000
  • 费用
  • └ city
  • String
  • 杭州
  • 城市
  • traffic_fee
  • TrafficFee
  • 费用
  • btrip_routes
  • BtripRoutes []
  • []
  • 行程费用
  • most_expensive
  • MostExpensive
  • {}
  • 最高价
  • └ vehicle_no
  • String
  • G7391
  • 班次
  • └ seat_grade
  • String
  • 商务座
  • 坐席级别
  • └ dep_time
  • String
  • 18:18
  • 出发时间
  • └ fee
  • Number
  • 23350
  • 费用
  • └ arr_time
  • String
  • 19:39
  • 到达时间
  • └ success
  • Boolean
  • true
  • 查询是否成功
  • cheapest
  • Cheapest
  • {}
  • 最低价
  • └ vehicle_no
  • String
  • K1185
  • 班次
  • └ seat_grade
  • String
  • 硬座
  • 坐席级别
  • └ dep_time
  • String
  • 08:51
  • 出发时间
  • └ fee
  • Number
  • 2450
  • 费用
  • └ arr_time
  • String
  • 10:46
  • 到达时间
  • └ dest_city
  • String
  • 杭州
  • 目的地
  • └ org_city
  • String
  • 上海
  • 出发地
  • └ err_msg
  • String
  • demo
  • 错误信息
  • └ dep_date
  • Date
  • 2020-12-12 00:00:00
  • 出发时间
  • └ success
  • Boolean
  • true
  • 是否成功
  • └ err_msg
  • String
  • demo
  • 错误信息
  • └ query_key
  • String
  • abc
  • 异步查询key。需要client再次尝试请求
  • └ errcode
  • Number
  • 0
  • 错误码
  • └ errmsg
  • String
  • demo
  • 错误信息

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
DingTalkClient client = new DefaultDingTalkClient("https://oapi.dingtalk.com/topapi/alitrip/btrip/price/query");
OapiAlitripBtripPriceQueryRequest req = new OapiAlitripBtripPriceQueryRequest();
OpenApiIntervalPriceRq obj1 = new OpenApiIntervalPriceRq();
obj1.setCorpid("corpid");
obj1.setFromWhere("杭州");
obj1.setUserid("ding12345");
obj1.setItineraryId("1245");
obj1.setStartTime(StringUtils.parseDateTime("2020-11-11 00:00:00"));
obj1.setEndTime(StringUtils.parseDateTime("2020-12-12 00:00:00"));
obj1.setToWhere("上海");
obj1.setCategory("flight");
obj1.setQueryKey("abc");
req.setReq(obj1);
OapiAlitripBtripPriceQueryResponse rsp = client.execute(req, access_token);
System.out.println(rsp.getBody());

响应示例

  • JSON示例
{
    "result":{
        "success":true,
        "module":{
            "hotel_fee_detail":[
                {
                        "criterion":30000,
                        "city":"杭州"
                }
            ],
            "traffic_fee":{
                "btrip_routes":[
                    {
                            "most_expensive":{
                                "vehicle_no":"G7391",
                                "seat_grade":"商务座",
                                "dep_time":"18:18",
                                "fee":23350,
                                "arr_time":"19:39"
                            },
                            "success":true,
                            "cheapest":{
                                "vehicle_no":"K1185",
                                "seat_grade":"硬座",
                                "dep_time":"08:51",
                                "fee":2450,
                                "arr_time":"10:46"
                            },
                            "dest_city":"杭州",
                            "org_city":"上海",
                            "err_msg":"demo",
                            "dep_date":"2020-12-12 00:00:00"
                    }
                ],
                "success":true,
                "err_msg":"demo"
            },
            "query_key":"abc"
        },
        "errcode":0,
        "errmsg":"demo"
    }
}

异常示例

  • JSON示例
{
	"errcode":88,
	"errmsg":"ding talk error"
}

错误码解释

错误码 错误描述 解决方案

API工具

如何获得此API

FAQ

返回
顶部