ECJiaWiki:Api:admin/express/staff/detail

来自ECJiaWiki
跳转至: 导航搜索

应用场景

 掌柜查看配送员详情

接口名称

 admin/express/staff/detail

Header请求参数

字段名 变量名 必填 类型 示例值 描述 since deprecated
设备唯一ID device-udid String a46d663d675d4858ea7d0a21c2de06e9 设备的唯一编号 1.3.0
设备客户端类型 device-client String android,iphone,h5,weapp 设备类型的描述 1.3.0
产品编号 device-code String 6015 产品编号 1.3.0
API版本 api-version String 1.6 API接口版本号 1.3.0

举例如下

{
    "device-udid" : "a46d663d675d4858ea7d0a21c2de06e9",
    "device-client" : "weapp",
    "device-code " : "6015",
    "api-version" : "1.6",
}

请求参数

字段名 变量名 必填 类型 示例值 描述
配送员id staff_id int 配送员id
分页信息 pagination pagination字典 分页信息
└ 每页显示条数 count Int 每页显示条数
└ 当前页数 page Int 当前页数

举例如下

{
      "staff_id" : 30,
       "pagination" : {
    	   "count" : 10,
    	   "page" : 1
      },
}

返回参数

字段名 变量名 必填 类型 示例值 描述
返回状态码 status Array {"succeed" : 1} 返回请求接口后的数据,succeed为1代表成功,0则为失败,失败后则返回error_code(错误code)及error_desc(错误说明)
返回信息 data Array 请求接口提供的返回信息
└ 店铺id store_id Int 店铺id
└ 配送员id staff_id Int 配送员id
└ 头像 avatar_img String 头像
└ 配送员名称 staff_name String 配送员名称
└ 昵称 nickname String 昵称
└ 员工编号 staff_number String 员工编号
└ 备注 introduction String 备注
└ 配送员手机号 mobile String 13468678174 配送员手机号
└ 邮箱 email String 邮箱
└ 在离线状态 online_status string 在离线状态(online在线,offline离线)
└ 在离线状态(中文) label_online_status string 在离线状态(在线,离线)
└ 配送员位置信息 express_user_location express_user_location字典 配送员位置信息
   └ 经度 longitude string 经度
   └ 维度 latitude string 维度
└ 派单总数 assign_count int 派单总数
└ 未完成总数 unfinished_count int 未完成总数
└ 已完成总数 finished_count int 已完成总数
└ 配送单列表 express_list array 配送单列表
   └ 配送单id express_id int 配送单id
   └ 配送单单号 express_sn string 配送单单号
   └ 配送地址 express_to_address string 配送地址
   └ 接单时间 formated_pickup_time string 接单时间
   └ 配送费用 formated_shipping_fee string 配送费用
   └ 配送状态 express_status string 配送状态(wait_assign待指派,wait_pickup待取货,sending配送中,finished已完成)
   └ 配送状态(中文) label_express_status string 配送状态(待指派,待取货,配送中,已完成)
└ 分页信息 paginated paginated字典 分页信息
   └ 总数 total Int 总数
   └ 当前返回数组的总条数 count Int 当前返回数组的总条数
   └ 是否有下一页 more Int 是否有下一页

成功举例如下

{
    "data": {
        "store_id":63,
        "staff_id": 79,
        "avatar_img": "http://www.yinuopai.com/content/apps/express/statics/images/touxiang.png",
        "staff_name": "测试平台1号配送员",
        "nickname": "",
        "user_ident": "005",
        "introduction" : "配送员小李",
        "mobile": "18672475112",
        "email": "18672475112@qq.com",
        "online_status":"online",
        "label_online_status":"在线",
        "express_user_location" : {
               "longitude" : "121.4158625918",
               "latitude"  : "31.235252261217",
        },
        "assign_count": 105,
        "unfinished_count": 10,
        "finished_count": 200,
        "express_list": [
            {
                "express_id": 11,
                "express_sn": "201801010293",
                "express_to_address" : "中山北路3553号301室"
                "formated_pickup_time": "2018-01-01 12:00:12",
                "formated_shipping_fee" : "¥11.00",
                "express_status":"wait_pickup",
                "label_express_status":"待取货"
            },
        ]
    },
    "status": {
        "succeed": 1
    },
    "paginated": {
        "total": 22,
        "count": 22,
        "more": 1
    }
}

失败举例如下

{
      "status" : {
            "succeed" : 0,
            "error_code" : "invalid_parameter",
            "error_desc" : "参数无效",
      }
}

注:错误编码