文档介绍:点我达 Open API 接口说明书
版本
更改记录
版本号
拟制/修改人
拟制/修改日期
主要更改内容
潘罗商/赵启龙
2015/07/27
创建
注1:每次更改归档文件时,需填写此表。
注2:文件第一次归档时,“更改理由”、“主要更改内容”栏写“无”。
API 列表
接口分类
接口名
简述
系统级输入参数
 详见《接口详细说明 》
订单操作
派发订单
派发新订单
获取订单配送信息
查询订单状态、配送员信息、位置等信息。
取消订单
取消订单
修改备注信息
修改点我达配送订单的备注信息
获取订单状态
当配送订单状态改变后,可以通过此接口获得改变后的订单状态。
Request Method
正式环境URL: api./api/v1/
Method: post
Format: json
编码方式:utf-8
接入申请
向点我达开放物流服务平台对接负责人提出申请,并通过邮件提交审核材料与信息。审核通过后,就可以获得接口调用相关权限和开发文档,从而调用点我达的API、享受点我达提供的配送服务。
审核材料
请以邮件形式,发送如下信息到对接负责人处进行审核,我们会及时给您回馈。
- 申请平台名:
-联系人姓名:
-联系手机号:
-申请方描述:
-经营类型:
-申请配送服务城市:
-愿意支付的配送费(每单):
-其他特别说明:
骑士服务:
骑士服务是更为高质量的最后一公里配送服务,点我达对骑士的配送服务质量有更高的要求。
骑手服务:
骑手服务的配送人员是来自于众包的社会人员,在参与点我达的培训、并在点我达的服务框架下为客户提供最后一公里的物流配送服务。
(服务定价由市场部门统一管理。)
*注: 派发订单接口调用成功表示向点我达物流开放平台下单成功、开始派单(在订单派发到某个配送员时才认为派单成功),因此需要后续调用获取订单状态接口监控派发订单的状态。订单若未成功派出,状态会由“派单中”进入“已取消”。
*若对接方在“配送中”状态下取消订单,由于配送服务已经发生,需要由对接方承担相应配送费用。
五、接口详细说明
派发订单
接口名称
order_send
接口描述
调用接口,向最合适的配送员派发订单配送任务。
正式环境URL: http://api./api/v1/order-
Method: post
字段名
类型
是否必须
示例
描述
pk
String
是
123456
向点我达平台申请的appkey
timestamp
Long
是
1436863897901
时间戳,进行接口调用时的时间戳,以秒计算时间
format
String
是
json
响应数据格式
sig
String
是
F5A5FF4850E7681B0676C4AAD268593353C2D135
appkey加密签名(系统级别参数不参与签名加密),签名使用SHA-1加密
请求参数
字段名
类型
是否必须
示例
描述
service_type
Integer
是
1
10 = 骑士, 0 = 骑手
order_original_id
String
是
fdj7387dskjle42
第三方对接平台的订单ID
order_remark
String
否
富瑞的秘密订单
订单备注
city_code
String
是
3100
城市编码(邮政编码去掉末两位, 如杭州3100,)
seller_name
String
是
肯德基宅急送(黄龙店)
商家店铺名称
seller_mobile
String
是
**********
商家联系方式
seller_address
String
是
西湖区天目山路307号史塔克基地食堂
商家文字地址
seller_lat
Float
是
商家纬度坐标.(坐标系为高德地图坐标系,又称火星坐标). (单位:度)
seller_lng
Float
是
商家经度坐标.(坐标系为高德地图坐标系,又称火星坐标) (单位:度)
consignee_name
String
是
托尼·史塔克
收货人姓名
consignee_mobile
String
是
**********