首页 > 开放平台文档
使用说明 接口说明 1.1费用详情接口 1.2派单接口 1.3订单状态改变通知 1.4主动取消订单 1.5查询账户余额

1.使用说明

第一步,注册企业/个人账号;

第二步,保证账户上有充足的余额;

第三步,获取专属partner_id(请求方标识),private_key,private_iv,public_key,public_iv;获取开放配置

第四步,填写接收订单信息以及状态更新的url地址链接(用于更新贵方平台订单信息,以及订单追踪,选填);

第四步,拼接http请求url,第三步申请的partner_id和private_key需作为必填参数一同发送;

第五步,接收http请求返回的数据,利用公共public_key,public_iv解析数据。

备注:开发环境请将v5.tuniaoapp.com更换为dev.tuniaoapp.com再调试,正式部署后再改回正式环境域名;开发环境partner_id,private_key,private_iv,public_key,public_iv无需申请,请下载demo示例代码查看

PHP版本demo下载

Java版本demo下载

2.接口说明

本接口基于http post方式,并且通讯数据将以加密方式传输,加密方式为:Base64( AES(通讯数据的utf-8编码值) ),将密文在http post的body中传输,其中,通讯数据是以JSON格式组装,并且编码方式为utf-8。返回内容在http post的response body中传输,使用相同的加密方式。

3.接口定义

1).派单

1.1).费用详情接口

获取费用详情
接口url http://v5.tuniaoapp.com/v1/Order/checkTotlePrice
接口http方法 post
接口http编码 utf-8
post参数列表
参数名 参数类型 参数说明
id string 请求方标识(由途鸟科技统一分配)[必填]
timestamp string(10) 时间戳(例如:1509677744)[必填]
lastest_time_m int 预约单的时间间隔(秒)计算方式:从用户选择的时间减去当前时间(例如:3600)[选填](不填为实时,填了为预约单)
car_id int 车型:22(固定值)[必填]
city_code int(6) 城市区域编码(根据高德地图定位获取,例:420502)[必填]
备注:city_code(城市区域编码)请参考高德行政区域查询接口获取https://lbs.amap.com/api/webservice/guide/api/district
goodsid int 商品类型:49(固定值)[必填]
origin string 起点坐标点,例如:111.327098,30.712961 [必填]
destination json 终点坐标点,(兼容单单和多单) 格式: ["经度,纬度","经度,纬度"](逗号间隔) 例如: ["111.327098,30.712961", "111.327098,30.712961"][必填]
sign string 安全校验数据AES-128-CBC(Base64(partner_id+timestamp+private_key)) [必填]
Response参数列表
参数名 参数类型 参数说明
Code string 1成功,非1失败
Message string 出错原因
Data
distance string 起点到终点的距离(米)
yunfei string 基础运费(元)
service_fee string 服务费(元)
price_tianqi string 天气补助费(元)
money_give string 已抵扣金额(元)
money_pay string 需支付金额(元)
allmoney string 总额(元)
goods string 货物品类id
tagsaddprice string 货物品类加价(元)
distance_every_point array 每个送货地址距离(米) [多单情况返回]
distance_price_point array 每个送货地址费用(元) [多单情况返回]
distance_price_percent array 每个送货地址占总距离比例(百分比) [多单情况返回]
参考备注
public_key:tuniaokeji
public_iv:2015031320180313
接口返回:
r0mKLp57l1XMjxbxWxfGueKbcItbN0f6+4Yv7WSEnORAr631sEzEVZrMHMoj5SV1Gh+HxuhkLM9gBvicWqPBwGx9qiPIeD6EUGSilCdFeSXbV93LAOWCxBac0QyEvYBKHzs7ZkWxniBJGqI4MrwI7bFArXs4D87opH5zsCrmDV8axHwSS3dbWOsSi8bCohL8t+EAkZqxQQ7SnhY6xk4LsTGSH4Cnl9566yQ9s3AzaDfoi2G3puVT2iSUFkYCMsl2Wm49q6ri3NC7Q1ZS4KZ0vI75Kg58D6Etk65n0QQlsaLchsXahEm9Nu5WVmdLrg+FXtrvRL55PMQygVzHpUUWQQ7CeGNRwxfRFCZDhIsJMLf6VWGvYlpihfhZELFMJ/ffNbKfdsjTKNgPFzT3q7DvH//0MNjujI/zXyFQeMIShTyz8QeFRi/b8sRZ9iXb7uYokDx0x8iSNNn3Ey+t+6sPUPQGBVq0y0sN+tHHdj8KsnUmo7Keul2T/awXnNJFbgqGqZsFkZriNfCwETNbjmZiW9akhIIxFzfqGz8GM9EtoRPtG3XC6Q4sN8H3X/fjd8sS8lgk3eyObWFvxUbw6nldgTWliJpXz++wP3pwjZn3qmU6lIdg0JykCxqxEchrU6K5PHStrOfk7Mfj4JMK+3hY/u2SjXcGZANmlZ0eY985KK7y9XfEiJF7ga77KXxN9EiTyV1c6L/clJ2Q1v2+qZ7+/4E4OPJxs74huT0+BB1GEWZ0lHZ2F8HG8WzuYAgaGSuUE8xnFmpA+gcSFeRhnGL2sUSBoGIulJtJlBHZK3j4HOmlPsJ5Qk015T//XZuTH4Fs
解析后返回结果:
{"Code":"1","Message":"下单成功!","Data":{"tuniao":[{"uid":"78982","nick_name":"途鸟-王语嫣","username":"途鸟-王语嫣","face":"http://tuniaopsimg.oss-cn-hangzhou.aliyuncs.com/face/20180730/1532934193977.jpg","lng":"111.328362","lat":"30.712803","order_qiang_finish":"16"}],"id":"784226","lng":"111.329397000","lat":"30.713200000","service_id":"1","car_id":"7","city_code":"420502","tuniao_icon":{"and_icon":"https://tuniao.oss-cn-hangzhou.aliyuncs.com/web/icon/car/big/7.png","ios_icon":"https://tuniao.oss-cn-hangzhou.aliyuncs.com/web/icon/car/big/7.png"},"allmoney":"7.00","push_count":"1","lastest_time_m":"1758","lastest_time_pc":"1534815000","yjhj":"0","order_used":{"money":"7.00"},"account_info":{"money":"1019.61","give":"0.00"}}}
					

1.2).派单接口

获取费用详情
接口url http://v5.tuniaoapp.com/v1/Order/order
接口http方法 post
接口http编码 utf-8
post参数列表
参数名 参数类型 参数说明
id string 请求方标识(由途鸟科技统一分配)
timestamp string(10) 时间戳(例如:1509677744)
lastest_time_m int 预约单的时间间隔(秒)计算方式:从用户选择的时间减去当前时间(例如:3600)[选填](不填为实时,填了为预约单)
car_id int 车型:22(固定值)
city_code int(6) 城市区域编码(根据高德地图定位获取,例:420502)
备注:city_code(城市区域编码)请参考高德行政区域查询接口获取https://lbs.amap.com/api/webservice/guide/api/district
goods string 美食(固定值)
goods_value string 货物内容补充,例如:炒饭炒面(可不填)
goods_more string 其他需求,如:需要多辣。(可不填)
goodsid int 49(固定值)
origin string 起点坐标点,例如:111.327098,30.712961
laddr string 起点位置。例如:宜昌万达广场A座
phone int(11) 发货人手机号码。
laddr_more string 起点位置备注说明。例如:1801室(可不填)
destination (5.0.8 废弃) string 终点坐标点,例如:111.327098,30.712961
raddr (5.0.8 废弃) string 终点位置。例如:宜昌万达广场A座
rphone (5.0.8 废弃) int(11) 收货人手机号码。
raddr_more (5.0.8废弃) string 终点位置备注说明。例如:1801室(可不填)
raddr json

收货地址信息(兼容单单和多单) 例如: [{"addr1":"收货地址1","addr2":"补充地址1","lng":"111.330049000","lat":"30.711528000","city_code":"420502","phone":"18500000000"},{"addr1":"收货地址2","addr2":"补充地址2","lng":"111.330049000","lat":"30.711528000","city_code":"420502","phone":"18500000000"}]
备注:city_code(城市区域编码)请参考高德行政区域查询接口获取https://lbs.amap.com/api/webservice/guide/api/district

allmoney float(11,2) Checktotleprice接口返回的allmoney
money_give float(11,2) Checktotleprice接口返回
service_fee float(11,2) Checktotleprice接口返回
price_tianqi float(11,2) Checktotleprice接口返回
distance int Checktotleprice接口返回
tagsaddprice int Checktotleprice接口返回
orderno string 订单编号(由提交方生成)
sign string 安全校验数据AES-128-CBC(Base64(partner_id+timestamp+private_key))
Response参数列表
参数名 参数类型 参数说明
Code string 1成功,非1失败
Message string 出错原因
Data
push_count int 推送到的总运力端数
id int 该订单在途鸟货运端的订单id
service_id int 该订单在途鸟货运端的服务类型id
allmoney string 总额(元)
order_used object 本次订单扣费金额
account_info object 派单人账户余额信息
参考备注
public_key:tuniaokeji
public_iv:2015031320180313
接口返回:
r0mKLp57l1XMjxbxWxfGuaVCffS32gZIXLqpvH1H+Wu2QjQeTBMON51VKvbnYN1bH8zMg668L+1FTZnMxHXnZVmHd/NKkC2KTY9dhQlAp86WVSaSDibpP1ls15/s0dYGyTi8pSTQzlrUBxb8CKHZdEuxKLe4pfc8d9WU5Jg0oHWvrDtsGSU/XM74cirAyigqDwGpqX3U4EvzpEXLvObPTtDbGVXI7v0nIaKeqP5Ddd6/aG1TUOGHNiaMaufVoKHQeJKGF2ilQrdM+c+DMUoFj4mb9rMjBmoibLgfp1K/yJrfvfdu58S5hMNe68ZELAksuNlORt/6Nu4w2i8MLNyu1nmqNN4JaFoTdDncY6D1x8zMS0xLkmSVi6Ja+FuaF9/PUhS20nGRTZKIQfRUeQGcSWl1K3BzBJRpCIH2yHR7fmhMp+orDUaRVxRzP4KjLdDpJw8RV/aS8HpjcTZ9VkGRkQ2tGMtjQ6hYAwUcH7s1MAbqdq23jPIr7tVjVsUXL4XZCvzPGu3q4W60QsqgPEylLNSJVCqaJ361qOtUC7UAb/Ejq8emZ/yNrk+KSB/jIzjkJ9Mbs8mXkiGPiBdEP/dc6N9KT7PtGRSbOH6tCoOUWY58nYIe0Kspc4ckiMRd00glzrq1Lf3TFkJb3aVtSh8xRQIgkeEryLr2ScDZ1w6QMwpfLr7IQmMxKnua8kXadLIij+iI6SAkbsNj4BFyoI0fhRecRn/Jyq5a4wm0vMGsunbTxg0ImxqZFBcOKm2YsmrU9YUVKhphqCR+8/K6v6zDkrQqb39qXwSnsgbEMBUQgpD7cNlmXLKOu1u1wwyYpegjO1gZymPoNrtoX20kHj4FO8MOdPLcFUR8CXkM8SGBMzgLsmCW35ccH3llVtqVHzQpCL38kkIUdRlne9ySn3ZiXwCfDg88AJOe2DThxtID82faAXQdEpqQO4F/B0zXGsCcr1M0fkLmgO+4JLANsMhObbcY+jFCiOI1iM7aE2e9LTRgsjp7BCLPbHNMPYO7oFFicAU6E6LJUypfSvsNlHtkfJjSoUphLKfKvrKTfOKwPTRn5dBQYcukB3n2jKDICxkXErxdhsKmcnL0sKVDKsPiiVb+D4uhisW4on7kmTHKU6uzwvWDSgHBLd3cTtsgHn61Eo5OEtQtry6wDZsHnHgfIn7gffgDLrC5oqwRDQQVaJ5nPAqm/xnkt4T07dg7KX0b55eDp/fiXBC/QNQ1f6rkZhFCqorVwmR3h5O3CvApiqxXm/Uq0D/qGbhFKA6NC/3BI2Nh6KTTEJhHw9DOwkpdWTd91tG0V2SkzaP7k86mY9S1WhFbzpwTgHxK0MXRyZWaZCzysNkDVeV4OfSMRFCzngTdNLAQ4KhmSkYpw9IsLhoOHgWFLUIHkAc/SBp2b5k1hAteQ21bm9R3wmcI+GY0gRD6LnJThBqaR14MTjJG+sg=
解析后:
{"Code":"1","Message":"下单成功!","Data":{"tuniao":[{"uid":"78982","nick_name":"途鸟-王语嫣","username":"途鸟-王语嫣","face":"http://tuniaopsimg.oss-cn-hangzhou.aliyuncs.com/face/20180730/1532934193977.jpg","lng":"111.328362","lat":"30.712801","order_qiang_finish":"16"}],"id":"784227","lng":"111.329397000","lat":"30.713200000","service_id":"1","car_id":"7","city_code":"420502","tuniao_icon":{"and_icon":"https://tuniao.oss-cn-hangzhou.aliyuncs.com/web/icon/car/big/7.png","ios_icon":"https://tuniao.oss-cn-hangzhou.aliyuncs.com/web/icon/car/big/7.png"},"allmoney":"7.00","push_count":"1","lastest_time_m":"1787","lastest_time_pc":"1534820040","yjhj":"0","order_used":{"money":"7.00"},"account_info":{"money":"1033.61","give":"0.00"}}}

1.3).订单状态改变通知

订单状态改变通知
接口url 由账号管理中自行设定
接口http方法 post
接口http编码 utf-8
post参数列表
参数名 参数类型 参数说明
id string 请求方标识(由途鸟科技统一分配)
timestamp string(10) 时间戳(例如:1509677744)
status int

1:订单已被抢

2:订单已取货

3:订单已送达

4:订单已取消

userinfo
status为1时存在
array

phone:骑手电话

lng:骑手坐标

lat:骑手坐标

name:骑手昵称

orderno string 该订单在第三方平台上的订单号(在派单接口中由第三方平台生成)
sign string 安全校验数据AES-128-CBC(Base64(partner_id+timestamp+private_key))
Response参数列表
参数名 参数类型 参数说明
Code string 1成功,非1失败
Message string 出错原因

1.4).主动取消订单

主动取消订单
接口url http://v5.tuniaoapp.com/v1/Order/orderCancel
接口http方法 post
接口http编码 utf-8
post参数列表
参数名 参数类型 参数说明
id string 请求方标识(由途鸟科技统一分配)
timestamp string(10) 时间戳(例如:1509677744)
oid int 派单接口返回的id
orderno string 该订单在第三方平台上的订单号(在派单接口中由第三方平台生成)
sign string 安全校验数据AES-128-CBC(Base64(partner_id+timestamp+private_key))
Response参数列表
参数名 参数类型 参数说明
Code string 1成功,非1失败
Message string 出错原因

订单只能在取货之前取消,即

1,派单后无人接,等待接单时;

2,订单被抢未取货;

其他状态不能取消。

参考备注

public_key:tuniaokeji

public_iv:2015031320180313

接口返回:

xRNmquGR8srfo3RAajKJFEo9Wok7FpeO8rhluKcKJUtkctmk71v0rTwteBH/g+wggOxT0euECKS86zhjbBl7/JNyqWoMSxLyLkY2s2ZNIyc=

解析后:

{ "Code": "3", "Message": "时间有误", "Data": "" }

1.5).查询账户余额

查询账户余额
接口url http://v5.tuniaoapp.com/v1/Account/myAccountInfo
接口http方法 post
接口http编码 utf-8
post参数列表
参数名 参数类型 参数说明
id string 请求方标识(由途鸟科技统一分配)
timestamp string(10) 时间戳(例如:1509677744)
sign string 安全校验数据AES-128-CBC(Base64(partner_id+timestamp+private_key))
Response参数列表
参数名 参数类型 参数说明
Code string 1成功,非1失败
Message string 出错原因
Data object 返回数据
返回派单账户可用余额信息:
	money:账户余额
	give:优惠赠送金额
参考备注
	public_key:tuniaokeji
	public_iv:2015031320180313
接口返回:
	r0mKLp57l1XMjxbxWxfGuYO8DoyeoIpzUojaFb2i6Ada8k+JZH+IJJGMn3gUns/CmakIJtuKaPJujqYgTs/4+lBx8uGVbHYbXle7 lHB5xdR65UONbSDKa/pscZzRqvIG54EFgt36gAIrZaNRt+Kuw1aWos66LIsvsA8bTO7CN3yf98zjQzs04Gdw5NGzILvYKhomxxL9ujP+1BfdlHsRE/HvvkIGXCwh8B9uJJudamA=
解析后:
	{"Code":"1","Message":"success","Data":{"money":"1033.61","give":"0.00"}}
			

扫码下载途鸟App

客服电话:400-835-2166

企业邮箱:tuniao@tuniaoji.com

关注我们:  

©2017 途鸟科技(上海)有限公司 All Rights Reserved 沪ICP备16023808号-1 途鸟科技(上海)有限公司,禁止非法复制