爱跑腿代我送对外接口文档

说明：

使用授权手机号和其他参数外加发起接口请求时间戳使用密码对接口参数进行加密标签产生验证签名，将产生签名字符串作为 signature的值，添加到接口请求参数中

测试DOMAIN：

https://apitest.ipaotui.com

正式DOMAIN：

https://api.ipaotui.com

加密/效验

说明：

1.将所有参数（sign除外）按照参数名的字母顺序排序,并用&连接

例：1.app_id=123456789&b=1&c=2&timestamp=1532218981

2.将以上字符串与 &app_key进行连接，得到加密前的字符串

例：app_id=123456789&b=1&c=2&timestamp=1532218981&app_key=99f8286ed488c6ba

3.对加密前的字符串进行MD5加密，并转换成小写字母，得到签名

例：a46f51e808ed2ec0fc6ff049176820f9

注意：

1.参数中包含中文时，中文保持原文即可，无需对其单独转码

2.时间戳timestamp在2分钟之内有效

3.在调用接口时，请勿传递app_key，以免信息泄露

4.加密的时候参数值为url，请以原值，非urlencode的值进行加密

账号绑定以及解绑

简要描述：

平台上进行爱跑腿账号的绑定以及解绑

一、平台上的各个商家可以自行注册爱跑腿账号进行绑定发单；

二、可以由平台统一使用一个爱跑腿账号进行绑定发单（该平台充值要开票外加6%税点）。

绑定之后，配送订单将由绑定的爱跑腿账号发布，订单的发布需要从账户余额内扣款，商家需要在注册的爱跑腿账户内进行充值。

绑定URL：

·DOMAIN/index.php?m=Api&c=PublishOpen&a=bindUser

请求方式：

POST

参数：

参数名	说明	示例	必选
app_id	第三方应用ID	492d9e8f72e45c843a893f5c6fe4361b	是
notify_url	订单状态回调URL	www.baidu.com	是
timestamp	unix时间戳	1481252461(当前时间)	是
signature	参数合法性验证	31238e2b48b9c6	是
phone	绑定手机号	13555555555	是
password	绑定账号对应的密码	123456	否
unique_id	第三方平台门店id（绑定成功之后，会回传）	123456	否

返回示例

{
    "State": "Success",
    "info": "成功授权！",
    "data": [],
    "code": 1
}

解绑URL：

·DOMAIN/index.php?m=Api&c=PublishOpen&a=unbindUser

请求方式：

POST

参数：

参数名	说明	示例	必选
phone	绑定手机号	13555555555	是
app_id	第三方应用ID	492d9e8f72e45c843a893f5c6fe4361b	是
timestamp	unix时间戳	1481252461(当前时间)	是
signature	参数合法性验证	31238e2b48b9c6	是

返回示例

{
    "State": "Success",
    "info": "操作成功",
    "data": "用户解绑成功！",
    "code": 1
}

订单价格查询(代送)

简要描述：

查询订单的配送价格

请求URL：

·DOMAIN/index.php?m=Api&c=PublishOpen&a=getOrderPrice

请求方式：

POST

参数：

参数名	说明	示例	必选

返回示例

{
    "State": "Success",
    "info": "操作成功",
    "data": {
        "price": 16,             //订单配送费原价（元）
        "cut_price": 14,         //优惠券后订单配送费（元）
        "length": 5.124,         //订单距离（千米）
        "can_pay":1,             //账户余额是否足够支付订单。1，足够；0，不足
     },
    "code": 1
}

发布配送订单(代送)

简要描述：

发布配送订单，由爱跑腿进行配送

请求URL：

·DOMAIN/index.php?m=Api&c=PublishOpen&a=addOrder

请求方式：

POST

参数：

参数名	说明	示例	必选

返回示例

{
    "State": "Success",                   //下单成功
    "info": "发布成功",
    "data": {
        "order_id": "47",                 //订单ID
        "state": "已发布",                 // 订单状态       
        "price" : 16,                     //订单配送费原价（元）
        "cut_price": 14,                  //优惠券后订单配送费（元）
        "add_price": 5,                   //加价金额（元）
        "statecode": 1,
        "localphone" : "13566666666" ,    //订单的区域代理商投诉电话
        
        //多单子地址ID，需要记录，在订单状态回调接口内有使用到
        "sub_addrs" : '[{"end_id":123,"end_address":"***"},{"end_id":124,"end_address":"***"}]', 
    },
    "code": 1
}

订单价格查询(专人专送)

简要描述：

查询订单的配送价格

请求URL：

·DOMAIN/index.php?m=Api&c=PublishOpen&a=getOrderPricePro

请求方式：

POST

参数：

参数名	说明	示例	必选

返回示例

{
    "State": "Success",
    "info": "操作成功",
    "data": {
        "price": 16,             //订单配送费原价（元）
        "cut_price": 14,         //优惠券后订单配送费（元）
        "length": 5.124,         //订单距离（千米）
        "can_pay":1,             //账户余额是否足够支付订单。1，足够；0，不足
     },
    "code": 1
}

发布配送订单(专人专送)

简要描述：

发布配送订单，由爱跑腿进行配送

请求URL：

·DOMAIN/index.php?m=Api&c=PublishOpen&a=addOrderPro

请求方式：

POST

参数：

参数名	说明	示例	必选

返回示例

{
    "State": "Success",                //下单成功
    "info": "发布成功",
    "data": {
        "order_id": "47",              //订单ID
        "state": "已发布",              // 订单状态       
        "price" : 16,                  //订单配送费原价（元）
        "cut_price": 14,               //优惠券后订单配送费（元）
        "add_price": 5,                //加价金额（元）
        "statecode": 1,
        "localphone" : "13566666666" , //订单的区域代理商投诉电话
        
        //多单子地址ID，需要记录，在订单状态回调接口内有使用到
        "sub_addrs" : '[{"end_id":123,"end_address":"***"},{"end_id":124,"end_address":"***"}]', 
    },
    "code": 1
}

订单加价

简要描述：

对发布的配送订单进行加价

请求URL：

·DOMAIN/index.php?m=Api&c=PublishOpen&a=addOrderPrice

请求方式：

POST

参数：

参数名	说明	示例	必选

返回示例

{
    "State": "Success",
    "info": "操作成功",
    "data": {
        "order_id": "order_id",       //订单ID
        "state": "已发布",            // 订单状态
        "statecode": "1", 
        "state_id": "1",
        "price" : "18.00",            //加价后订单配送费（元）

    },
    "code": 1
}

订单列表查询

简要描述：

获取该账号已经发布的订单

请求URL：

·DOMAIN/index.php?m=Api&c=PublishOpen&a=getOrderList

请求方式：

POST

参数：

参数名	说明	示例	必选

返回示例

{
    "State": "Success",
    "info": "执行成功",
    "data": {
        "total_rows": "57",
        "total_pages": 5,
        "size": "10",
        "now_page": "0",
        "next_page": 1,
        "data": [
            {
                "order_id": "2670",                                 // 订单id
                "title": "温州市鹿城区市府路到温州市新城汽车站",      //标题
                "state": "已发布",                                  //订单状态
                "add_time": "2016-06-14 11:28:01",                 //订单添加时间
                "price": "11",                                     //订单价格（元）
            },...
        ],
    "code": 1
}

订单详情查询

简要描述：

查询某个发布订单的详情信息

请求URL：

·DOMAIN/index.php?m=Api&c=PublishOpen&a=getOrderInfo

请求方式：

POST

参数：

参数名	说明	示例	必选

返回示例

{
    "State": "Success",
    "info": "操作成功",
    "data": {
        "order_id": "1630183",
        "title": "温州市万达广场C幢6楼666室到温州市铂金家园~汤家桥南路",
        "start_address": "万达广场C幢6楼666室",
        "end_address": "铂金家园~汤家桥南路",
        "start_location": "120.818031,27.926274",      //百度坐标系
        "end_location": "120.712339,27.9794",          //百度坐标系
        "start_city": "温州市",
        "end_city": "温州市",
        "state": "待评价",
        "statecode" : "10",
        "add_time": "2018-11-12 10:57:27",
        "length": "14.05",                              //订单距离（千米）
        "receive": "跑男4",
        "receive_phone": "13899999999"
        "price": "14.00元",
        "content": "农场香辣鸡腿堡x3 48.00元, ",
        "good_info": "测试店铺名称（温州总店） #1",
        "send_finish_key_phones": "13587866718",
        "pickup_pic_url": "https://***.***.***",        //取货照片
        "finish_pic_url": "https://***.***.***",        //送达照片
    },
    "code": 1
}

订单完成

简要描述：

完成某个发布的订单

请求URL：

·DOMAIN/index.php?m=Api&c=PublishOpen&a=finishOrder

请求方式：

POST

参数：

参数名	说明	示例	必选

返回示例

{
    "State": "Success", 
    "info": "执行成功",
    "data": {
        "order_id": "5187",        //订单ID
        "state": "待评价",         // 订单状态
        "statecode": 10
    },
    "code": 1
}

订单取消

简要描述：

取消某个发布的订单。

骑手已接单，进行取消，扣除部分配送费补偿骑手；

骑手已取货，进行取消，扣除部分配送费补偿骑手。

请求URL：

·DOMAIN/index.php?m=Api&c=PublishOpen&a=cancelOrder

请求方式：

POST

参数：

参数名	说明	示例	必选

返回示例（直接取消）

{
    "State": "Success",              //执行成功
    "info": "执行成功",
    "data": {
        "order_id": "3809073",       //订单ID
        "state": "已取消",            //订单状态
        "statecode": "7",
        "refund_price": "17",        //实际退回金额（元）
        "fine_money"："2"            //扣款金额（元）
    },
    "code": 1
}

返回示例（需骑手同意）

{
    "State": "Success",             //执行成功
    "info": "执行成功",
    "data": {
        "order_id": "3809073",      //订单ID
        "state": "待同意放弃",       //订单状态
        "statecode": 5
    },
    "code": 1
}

获取账户余额

简要描述：

获取对应账户的余额信息

请求URL：

·DOMAIN/index.php?m=Api&c=PublishOpen&a=getBalance

请求方式：

POST

参数：

参数名	说明	示例	必选

返回示例

{
    "State": "Success",
    "info": "操作成功",
    "data": {
        "balance": "9746.00",      //账户余额（元）
        "free": "9746.00",         //可用余额（元）
        "freeze": "254.00",        //冻结余额（元）
        "bond": "0.00",
        "total_income": "0.00",
        "total_expenses": "0.00",
        "total_integral": "0",
        "withdraw_show": "0",
        "coupon_count": "0"
    },
    "code": 1
}

获取账户账单

简要描述：

获取对应账户的账单信息

请求URL：

·DOMAIN/index.php?m=Api&c=PublishOpen&a=getFinanceBills

请求方式：

POST

参数：

参数名	说明	示例	必选

返回示例

{
    "State": "Success",
    "info": "操作成功",
    "data": {
        "list": [
            {
                "bill_id": "19971",
                "user_balance": "8818.18",
                "money": "5.00",
                "description": "付款给订单成功 (14182)",
                "add_time": "1528432542"
            },
            {
                "bill_id": "19970",
                "user_balance": "8823.18",
                "money": "5.00",
                "description": "付款给订单成功 (14181)",
                "add_time": "1528430823"
            },
        ],
        "last_id": "19880"
    },
    "code": 1
}

获取骑手GPS

简要描述：

获取对应骑手的位置信息

请求URL：

·DOMAIN/index.php?m=Api&c=PublishOpen&a=getGPS

请求方式：

POST

参数：

参数名	说明	示例	必选

返回示例

{
    "State": "Success",
    "info": "操作成功",
    "data": {
        "receive": "张三",
        "receive_phone": "18966668888",
        "gps": "120.729638,27.990437",      //百度坐标系
    },
    "code": 1
}

订单状态回调

简要描述：

状态回调接口

请求URL：

由被调用第三方平台提供，在账号绑定的时候进行提交

请求方式：

POST

参数：

参数名	说明	示例	必选

State

state=1  订单发布中等待骑手接单
state=8  订单已接单
state=31 订单已接单（转派订单）
state=21 已到店 
state=22 已取货 (可以判断送货中)
state=9  已送达
state=19 多地址订单，其中子地址已送达
state=7  订单取消退款

返回示例

{   
　　"State": "Success",          
    "info": "回调接收成功",
    "code": "1",

}

门店绑定回调

简要描述：

门店绑定回调接口，在平台完成账号绑定之后，会调用该接口

请求URL：

由被调用第三方平台提供，在个人信息页面设置

请求方式：

POST

参数：

参数名	说明	示例	必选

返回示例

{   
　　"State": "Success",          
    "info": "回调接收成功",
    "code": "1",

}

充值接口

简要描述：

获取充值网页

请求URL：

·DOMAIN/index.php?m=Api&c=PublishOpen&a=getRechargeUrl

请求方式：

POST

参数：

参数名	说明	示例	必选

返回示例

{
    "State": "Success",
    "info": "操作成功",
    "data": {
        "url": "https://api.ipaotui.com/index.php?m=Api&c=PublishOpen&a=wapRechargeUrl&openid=28937ff3ab*******59372959cc184" //充值网页
    },
    "code": 1
}

查询订单取消费用

简要描述：

查询订单取消费用

请求URL：

·DOMAIN/index.php?m=Api&c=PublishOpen&a=checkCancelFee

请求方式：

POST

参数：

参数名	说明	示例	必选

返回示例

{
    "State": "Success",
    "info": "操作成功",
    "data": {
        "refund_price": "17",    //实际退回金额（元）
        "fine_money"："2"        //扣款金额（元）
    },
    "code": 1
}

查询订单轨迹信息

简要描述：

查询某个订单的轨迹情况

请求URL：

·DOMAIN//index.php?m=Api&c=PublishOpen&a=getGpsList

请求方式：

POST

参数：

参数名	说明	示例	必选

返回示例

{
    "State": "Success",
    "info": "操作成功",
    "data": {
        "source_order_no": "1090****550298640",    //三方订单号
        "order_no": "202508261644432826",
        "order_id": "124462826",
        "rider_track_points": [
            {
                "rider_name": "刘骑手",
                "rider_phone": "133****8887",     //骑手手机号
                "longitude": 106.941618,          //经度（百度坐标系）
                "latitude": 27.72012,             //纬度（百度坐标系）
                "at_time": 1756197886
            },
            {
                "rider_name": "刘骑手",
                "rider_phone": "133****8887",  
                "longitude": 106.941501,
                "latitude": 27.720124,
                "at_time": 1756197950
            },
            
             ......

            {
                "rider_name": "刘骑手",
                "rider_phone": "133****8887",
                "longitude": 106.940632,
                "latitude": 27.71743,
                "at_time": 1756198388
            }
        ]
    },
    "code": 1
}

开发文档

爱跑腿代我送对外接口文档

说明：

测试DOMAIN：

正式DOMAIN：

加密/效验

说明：

注意：

账号绑定以及解绑

简要描述：

绑定URL：

请求方式：

参数：

返回示例

解绑URL：

请求方式：

参数：

返回示例

订单价格查询(代送)

简要描述：

请求URL：

请求方式：

参数：

返回示例

发布配送订单(代送)

简要描述：

请求URL：

请求方式：

参数：

返回示例

订单价格查询(专人专送)

简要描述：

请求URL：

请求方式：

参数：

返回示例

发布配送订单(专人专送)

简要描述：

请求URL：

请求方式：

参数：

返回示例

订单加价

简要描述：

请求URL：

请求方式：

参数：

返回示例

订单列表查询

简要描述：

请求URL：

请求方式：

参数：

返回示例

订单详情查询

简要描述：

请求URL：

请求方式：

参数：

返回示例

订单完成

简要描述：

请求URL：

请求方式：

参数：

返回示例

订单取消

简要描述：

请求URL：

请求方式：

参数：

返回示例（直接取消）

返回示例（需骑手同意）

获取账户余额

简要描述：

请求URL：

请求方式：

参数：

返回示例

获取账户账单