阿里云智能物流服务api文档.pdfVIP

阿里云智能物流服务 API 文档 使用说明：接口调用方按照附录中要求的订单和车辆数据格式准备数据，依照任 务提交接口说明提交任务，成功后返回任务查询ID，并使用该任务查询ID 通过 任务结果查询接口查看任务执行状态和结果。 1. 任务提交接口 请求URL: http://${url}/routes 请求方式： POST Content-Type: application/x-www-form-urlencoded Charset: UTF-8 请求参数： 参数名称 参数说明 appKey 阿里云提供公钥 （32 位） version 版本号, 当前版本为v1 请求对应时刻,包含毫秒。服务器端会验证时间戳的有效性，例如 timeStamp 是服务器时间戳5 分钟之前的请求则视为无效请求。 签名，签名规则：signature 使用md5 算法输出32 位大写字符串 sign sign=signature(appKey+orders+timeStamp+vehicles+version) orders 订单数据，JSON 格式，见附录2 vehicles 车辆数据，JSON 格式，见附录3 返回数据： status 请求返回状态码，见附录4 message 请求返回状态说明，见附录4 timeStamp 请求结果创建时间 data 任务查询ID 例如： { data: 7ae21785b6c34f018bd1d7c7ea6509c1, message: 任务提交成功, status: 200, timeStamp: 2017-04-28 13:14:25 } 2. 任务结果查询接口 请求URL: http://${url}/result 请求方式： GET Content-Type: application/x-www-form-urlencoded Charset: UTF-8 请求参数： 参数名称 参数说明 appKey 阿里云提供公钥 （32 位） 任务提交接口返回的任务查询ID qid timeStamp 请求对应时刻,包含毫秒。服务器端会验证时间戳的有效性，例如 是服务器时间戳5 分钟之前的请求则视为无效请求。 version 版本号, 当前版本为v1 签名，签名规则：signature 使用md5 算法输出32 位大写字符串 sign sign=signature(appKey+qid+timeStamp+version) 返回数据： status 请求返回状态码，见附录4 message 请求返回状态说明，见附录4 timeStamp 请求结果创建时间 data 任务查询ID 例如： a) 任务未执行完成： { data: null, message: 任务运行中, status: 201, timeStamp: 2017-04-28 13:14:25 } b) 任务执行成功：见附录1 附录 1 任务状态查询接口返回数据格式示例 { data: { taskNum: 1, totalCost: 2038000, totalLoadTime: 60,