文 档 中 心 / Document Center
搜索 管理中心
壹川接口文档V3
获取管辖城际专线列表
更新时间:2018-04-19 09:26:12   更新人员:叶洋   文档状态:完成 #178    测试接口
摘要
获取管辖城际专线列表
  1. 接口基本信息
    接口名称:获取专线列表
    请求方法:GET
    接口地址:line/specialline
    登录验证:是
  2. 请求参数
    参数名 参数 数据类型 是否必须 示例值 说明
    page 分页 int
    row 条数 int 条数/页
    start_net_id 起点id string
    end_net_id 终点id string
    title 线路名称 string
  3. 响应数据参数
    参数名 参数 数据类型 示例值 说明
    line_id 专线id string
    type 线路类型 int 该值为1,表示专线
    start_net_id 起始网点id string
    end_net_id 终止网点id string
    status 启用禁用状态 int 1为启用,0为禁用
    run_status 运行状态 int 1为正常运营中,0为非运营中
    approval_status 平台认证状态 int 1为平台认证,0为非认证
    protocol_status 多点协商状态 int 1为协商完成,0为协商中
    distance 总计估算距离 int 单位米
    duration 总计估算时间 int 单位:秒
    overtime_limit 超时时间设置 int 0为不算超时
    run_times 线路支行次数 int
    waybill_count 运单数量 int 走过该条专线的运单数量统计
    listbill_count 集装单量 int 走过该条专线的集装单(转运、配载)单量统计
    create_time 创建时间 string
    create_by{} 创建人信息 object
    ├ uid ├ 创建人uid string
    ├ code ├ 创建人编码 string
    ├ username ├ 创建人用户名 string
    ├ nickname ├ 创建人昵称 string
    └ realname └ 创建人真实姓名 string
    update_time 更新时间 string
    update_by{} 更新人信息 object
    ├ uid ├ 更新人uid string
    ├ code ├ 更新人代码 string
    ├ username ├ 更新人用户名 string
    ├ nickname ├ 更新人昵称 string
    └ realname └ 更新人真实姓名 string
    base_price 专线底价 float
    title 专线名称简称 string
    full_title 专线名称全称 string
    initials 名称首字母索引 string
    description 专线描述 string
    protocol_notpass 协商未通过的网点 string 多个用逗号分隔
    path_ids 线路经过的网点 string 网点用逗号分隔
    path_data{} 路线配置数据 object
    ├ line_type ├ 线路类型 int 1专线,0普线
    ├ total_base_price ├ 费用底价总计 float
    ├ is_multi ├ 是否是多专线 bool
    ├ path_ids ├ 线路经过的网点集合 string
    ├ charge_main{} ├ 计费规则 object
    │ ├ gbw[] │ ├ 重货方案 array 按重量算的计费方案
    │ │ ├ wmin │ │ ├ 最小重量 float
    │ │ ├ wmax │ │ ├ 最大重量 float
    │ │ ├ wdj │ │ ├ 区间单价 float
    │ │ ├ wxfl │ │ ├ 多线下浮率 float 单位:百分之一
    │ │ ├ wdesc │ │ ├ 阶梯费用文字描述 string
    │ │ └ wformula │ │ └ 阶梯费用公式 string
    │ └ gbv[] │ └ 轻货方案 array
    │   ├ vmin │   ├ 最小体积 float
    │   ├ vmax │   ├ 最大体积 float
    │   ├ vdj │   ├ 区间单价 float
    │   ├ vxfl │   ├ 多线下浮率 float
    │   ├ vdesc │   ├ 阶梯费用文字描述 string
    │   └ vformula │   └ 阶梯费用公式 string
    ├ sections_divide[] ├ 站点分成项 array
    │ ├ sort │ ├ 站点顺序 int
    │ ├ net_id │ ├ 网点id string
    │ ├ rate │ ├ 分成占比 float
    │ └ base_price │ └ 底价分得 float
    └ sublines_conf[] └ 子线路集合 array
      ├ sort   ├ 子线路顺序 int
      ├ net_from   ├ 出发网点 string
      ├ net_to   ├ 到达网点 string
      ├ sub_rate   ├ 子线路段占总额分成比例 float
      ├ all_rate_from   ├ 子线路段起点占总额分成比例 string
      ├ all_rate_to   ├ 子线路段终点占总额分成比例 float
      ├ sub_rate_from   ├ 子线路段起点占该线额分成比例 float
      └ sub_rate_to   └ 子线路段终点占该线额分成比例 float
    start_net{} 起始网点信息 object
    ├ net_id ├ 起始网点id string
    ├ com_id ├ 所属机构id string
    ├ code ├ 网点编码 string
    ├ name ├ 起始网点名称 string
    ├ contacts ├ 起始网点联系人 string
    ├ mobile ├ 起始网点手机 string
    ├ lng ├ 起点经度 float
    ├ lat ├ 起点纬度 float
    └ district_id └ 所在地理地区 int
    end_net{} 终止网点信息 object
    ├ net_id ├ 终止网点id string
    ├ com_id ├ 所属机构id string
    ├ code ├ 网点编码 string
    ├ name ├ 终止网点名称 string
    ├ contacts ├ 终止网点联系人 string
    ├ mobile ├ 终止网点手机 string
    ├ lng ├ 终点经度 float
    ├ lat ├ 终点纬度 float
    └ district_id └ 所在地理地区 int
    path_nets[] 线路所经网点数据 array
    ├ net_id ├ 终止网点id string
    ├ com_id ├ 所属机构id string
    ├ code ├ 网点编码 string
    ├ name ├ 终止网点名称 string
    ├ contacts ├ 终止网点联系人 string
    ├ mobile ├ 终止网点手机 string
    ├ lng ├ 终点经度 float
    ├ lat ├ 终点纬度 float
    ├ district_id ├ 所在地理地区 int
    └ cominfo{} └ 所属机构信息 object
      ├ com_id   ├ 机构id string
      ├ code   ├ 机构编码 string
      ├ name   ├ 机构名称 string
      ├ address   ├ 机构地址 string
      ├ contacts   ├ 机构联系人 string
      └ mobile   └ 机构联系电话 string
  4. 请求示例
    请求例子:
     
    apirq('line/specialline', {
        data: {
            "line_id": "a685ede5450a6836"
        }
    }) 
    
    返回数据结果:
     
    {
        "code": 0,
        "msg": "ok",
        "time": "1524044251",
        "data": {
            "page": 1,
            "row": 15,
            "count": 1,
            "total_count": 1,
            "total_page": 1,
            "lists": [
                {
                    "line_id": "a685ede5450a6836",
                    "type": 1,
                    "start_net_id": "d466b9497ccc7924",
                    "end_net_id": "c84dfc14b0fe119f",
                    "status": 1,
                    "run_status": 1,
                    "approval_status": 1,
                    "protocol_status": 0,
                    "distance": 234154,
                    "duration": 24213,
                    "overtime_limit": 0,
                    "run_times": 0,
                    "waybill_count": 0,
                    "listbill_count": 0,
                    "create_time": "2018-04-18 13:55:41",
                    "create_by": {
                        "uid": "0000000000000001",
                        "code": "U1000000",
                        "username": "administrator",
                        "nickname": "超级管理员",
                        "realname": "超级管理员"
                    },
                    "update_time": "2018-04-18 17:33:03",
                    "update_by": {
                        "uid": "0000000000000001",
                        "code": "U1000000",
                        "username": "administrator",
                        "nickname": "超级管理员",
                        "realname": "超级管理员"
                    },
                    "delete_time": null,
                    "base_price": "5.0000",
                    "title": "测试修改专线22",
                    "full_title": "测试专线3",
                    "initials": "cstjzx",
                    "description": "这是一条测试添加的专线",
                    "protocol_notpass": ",d466b9497ccc7924,a6bf2a0c694e4117,1e23852bfc7ec92",
                    "path_ids": ",d466b9497ccc7924,a6bf2a0c694e4117,1e23852bfc7ec92a,c84dfc14b0fe119f,",
                    "path_data": {
                        "line_type": 1,
                        "total_base_price": 5,
                        "is_multi": true,
                        "path_ids": ",d466b9497ccc7924,a6bf2a0c694e4117,1e23852bfc7ec92a,c84dfc14b0fe119f,",
                        "charge_main": {
                            "gbv": [
                                {
                                    "vdesc": "从0到20方单价为8.9元,多线时下浮百分之3",
                                    "vdj": 8.9,
                                    "vformula": "[[vol]]*8.9*(1-[[mul]]*0.03)",
                                    "vmax": 20,
                                    "vmin": 0,
                                    "vxfl": 3
                                },
                                {
                                    "vdesc": "从20到80方单价为8.5元,多线时下浮百分之5",
                                    "vdj": 8.5,
                                    "vformula": "[[vol]]*8.5*(1-[[mul]]*0.05)",
                                    "vmax": 80,
                                    "vmin": 20,
                                    "vxfl": 5
                                }
                            ],
                            "gbw": [
                                {
                                    "wdesc": "从0到3千克单价为1.9元,多线时下浮百分之3",
                                    "wdj": 1.9,
                                    "wformula": "[[wgt]]*1.9*(1-[[mul]]*0.03)",
                                    "wmax": 3,
                                    "wmin": 0,
                                    "wxfl": 3
                                },
                                {
                                    "wdesc": "从3到20千克单价为1.6元,多线时下浮百分之3",
                                    "wdj": 1.6,
                                    "wformula": "[[wgt]]*1.6*(1-[[mul]]*0.03)",
                                    "wmax": 20,
                                    "wmin": 3,
                                    "wxfl": 3
                                },
                                {
                                    "wdesc": "从20到100千克单价为1.1元,多线时下浮百分之6",
                                    "wdj": 1.1,
                                    "wformula": "[[wgt]]*1.1*(1-[[mul]]*0.06)",
                                    "wmax": 100,
                                    "wmin": 20,
                                    "wxfl": 6
                                }
                            ]
                        },
                        "sections_divide": [
                            {
                                "sort": 0,
                                "net_id": "d466b9497ccc7924",
                                "rate": 30,
                                "base_price": 1.5
                            },
                            {
                                "sort": 1,
                                "net_id": "a6bf2a0c694e4117",
                                "rate": 25,
                                "base_price": 1.25
                            },
                            {
                                "sort": 2,
                                "net_id": "1e23852bfc7ec92a",
                                "rate": 5,
                                "base_price": 0.25
                            },
                            {
                                "sort": 3,
                                "net_id": "c84dfc14b0fe119f",
                                "rate": 40,
                                "base_price": 2
                            }
                        ],
                        "sublines_conf": [
                            {
                                "sort": 0,
                                "net_from": "d466b9497ccc7924",
                                "net_to": "a6bf2a0c694e4117",
                                "sub_rate": 40,
                                "all_rate_from": 30,
                                "all_rate_to": 10,
                                "sub_rate_from": 75,
                                "sub_rate_to": 25
                            },
                            {
                                "sort": 1,
                                "net_from": "a6bf2a0c694e4117",
                                "net_to": "1e23852bfc7ec92a",
                                "sub_rate": 17,
                                "all_rate_from": 15,
                                "all_rate_to": 2,
                                "sub_rate_from": 88.235294117647,
                                "sub_rate_to": 11.764705882353
                            },
                            {
                                "sort": 2,
                                "net_from": "1e23852bfc7ec92a",
                                "net_to": "c84dfc14b0fe119f",
                                "sub_rate": 43,
                                "all_rate_from": 3,
                                "all_rate_to": 40,
                                "sub_rate_from": 6.9767441860465,
                                "sub_rate_to": 93.023255813953
                            }
                        ]
                    },
                    "start_net": {
                        "net_id": "d466b9497ccc7924",
                        "com_id": "05d48fa8743570b0",
                        "code": "N89672",
                        "name": "杭州",
                        "contacts": "李云",
                        "mobile": "13422223333",
                        "lng": "120.181620",
                        "lat": "30.229713",
                        "district_id": 44189
                    },
                    "end_net": {
                        "net_id": "c84dfc14b0fe119f",
                        "com_id": "05d48fa8743570b0",
                        "code": "N71809",
                        "name": "江夏2",
                        "contacts": "王小云",
                        "mobile": "132001244456",
                        "lng": "113.283244",
                        "lat": "23.211662",
                        "district_id": 1692
                    },
                    "path_nets": [
                        {
                            "net_id": "1e23852bfc7ec92a",
                            "com_id": "dc332415f1c87f9b",
                            "code": "N69046",
                            "name": "测试一个网s点222",
                            "contacts": "刘长明",
                            "mobile": "13212345678",
                            "lng": "30.123000",
                            "lat": "40.155230",
                            "district_id": 3,
                            "cominfo": {
                                "com_id": "dc332415f1c87f9b",
                                "code": "C38086",
                                "name": "杨天天",
                                "address": "北京市海淀区学院路37号北京航空航天大学",
                                "contacts": "1321456789",
                                "mobile": "要小李"
                            }
                        },
                        {
                            "net_id": "a6bf2a0c694e4117",
                            "com_id": "05d48fa8743570b0",
                            "code": "N16385",
                            "name": "长沙",
                            "contacts": "王小二",
                            "mobile": "13222224444",
                            "lng": "113.008840",
                            "lat": "28.191049",
                            "district_id": 19806,
                            "cominfo": {
                                "com_id": "05d48fa8743570b0",
                                "code": "C57732",
                                "name": "天天向上2",
                                "address": "四川省成都市青羊区西御河街道大树拐街15号五福街56号院",
                                "contacts": "李白",
                                "mobile": "13212345678"
                            }
                        },
                        {
                            "net_id": "c84dfc14b0fe119f",
                            "com_id": "05d48fa8743570b0",
                            "code": "N71809",
                            "name": "江夏2",
                            "contacts": "王小云",
                            "mobile": "132001244456",
                            "lng": "113.283244",
                            "lat": "23.211662",
                            "district_id": 1692,
                            "cominfo": {
                                "com_id": "05d48fa8743570b0",
                                "code": "C57732",
                                "name": "天天向上2",
                                "address": "四川省成都市青羊区西御河街道大树拐街15号五福街56号院",
                                "contacts": "李白",
                                "mobile": "13212345678"
                            }
                        },
                        {
                            "net_id": "d466b9497ccc7924",
                            "com_id": "05d48fa8743570b0",
                            "code": "N89672",
                            "name": "杭州",
                            "contacts": "李云",
                            "mobile": "13422223333",
                            "lng": "120.181620",
                            "lat": "30.229713",
                            "district_id": 44189,
                            "cominfo": {
                                "com_id": "05d48fa8743570b0",
                                "code": "C57732",
                                "name": "天天向上2",
                                "address": "四川省成都市青羊区西御河街道大树拐街15号五福街56号院",
                                "contacts": "李白",
                                "mobile": "13212345678"
                            }
                        }
                    ]
                }
            ]
        }
    } 
    
本书创建于 2018-03-30 12:03:13 ?如有疑问,请联系技术人员