帮助文档

# 车辆档案

# 接口URL

  • 测试环境: http://apitest.dudubashi.com/index.php/api/open/vehicle_record
  • 线上环境: http://wx.dudubashi.com/index.php/api/open/vehicle_record

# 请求方法

post

# 请求参数

名称 类型 说明 是否必须
token string 动态访问授权码 Y

# 返回参数

名称 类型 说明 是否必须
city string 城市 Y
suppliers string 供应商 Y
plate_number string 车牌号 Y

# 返回数据示例(json格式)

{
	"result": "0000",
	"data": [{
		"city": "深圳",
		"suppliers": "深圳市明成达运输有限公司",
		"plate_number": "粤BDF815"
	}, {
		"city": "深圳",
		"suppliers": "辉盛车队",
		"plate_number": "粤SD8030"
	}],
	"info": "成功"
}

# 司机档案

# 接口URL

  • 测试环境: http://apitest.dudubashi.com/index.php/api/open/driver_record
  • 线上环境: http://wx.dudubashi.com/index.php/api/open/driver_record

# 请求方法

post

# 请求参数

名称 类型 说明 是否必须
token string 动态访问授权码 Y

# 返回参数

名称 类型 说明 是否必须
city string 城市 Y
suppliers string 供应商 Y
driver_name string 司机名称 Y

# 返回数据示例(json格式)

{
	"result": "0000",
	"data": [{
		"city": "",
		"suppliers": "友盟车队",
		"driver_name": "陈荣华"
	}, {
		"city": "",
		"suppliers": "侨城车队",
		"driver_name": "李广"
	}],
	"info": "成功"
}

# 线路信息

# 接口URL

  • 测试环境: http://apitest.dudubashi.com/index.php/api/open/line_info
  • 线上环境: http://wx.dudubashi.com/index.php/api/open/line_info

# 请求方法

post

# 请求参数

名称 类型 说明 是否必须
token string 动态访问授权码 Y
city_name string 城市名称，例如：深圳，默认全部 N

# 返回参数

名称 类型 说明 是否必须
city string 城市 Y
suppliers string 供应商 Y
bus_line_id string 线路id Y
line_code string 班车线路编码 Y
status string 线路状态（1正常，0已删除，-1已停运） Y

# 返回数据示例(json格式)

{
	"result": "0000",
	"data": [{
		"city": "深圳",
		"suppliers": "华光达车队",
		"line_code": "102",
		"status": "1"
	}, {
		"city": "深圳",
		"suppliers": "华光达车队",
		"line_code": "114",
		"status": "-1"
	}],
	"info": "成功"
}

# 班次及站点信息

# 接口URL

  • 测试环境: http://apitest.dudubashi.com/index.php/api/open/line_site_info
  • 线上环境: http://wx.dudubashi.com/index.php/api/open/line_site_info

# 请求方法

post

# 请求参数

名称 类型 说明 是否必须
token string 动态访问授权码 Y
is_pagination int 是否需要分页 1是 ，0 否，默认不分页 N
page int 页码，每页20条 N
line_id int 班次id N

# 返回参数

名称 类型 说明 是否必须
city string 城市 Y
suppliers string 供应商 Y
line_code string 班车线路编码 Y
line_captcha string 班次口令验证码 Y
status string 线路状态（1正常，0已删除，-1已停运） Y
line_id string 班次ID Y
nav_name string 班次类型 Y
line_title string 班次名称 Y
line_remark string 班线描述 Y
time_range string 发车区间 Y
line_start_time string 发车时间 Y
start_site string 始发站 Y
end_site string 终点站 Y
bus_code string 车牌号 Y
line_contact string 联系人及联系方式 Y
line_rule string 运行时间（工作日，休息日周六，休息日周日） Y
line_price string 票价 Y
site_id string 站点ID Y
site_name string 站点名称 Y
site_lng string 站点经度 Y
site_lat string 站点纬度 Y
site_type int 站点类型（1：上车站点；2：下车站点； Y
site_type_new int 站点类型，针对穿梭车特殊处理（1：上车站点；2：下车站点；3：上下车站点） Y
dates array 未来7天的开通日期列表，如 ['2019-06-13','2019-06-20','2019-06-27'] Y
total_page int 总页数 Y

# 返回数据示例(json格式)

{
    "result": "0000",
	"data" : [
		{
				"city": "深圳",
				"suppliers": "华光达车队",
				"line_code": "102",						// 线路编号

				"line_id": "102",						// 班次ID
				"nav_name": "上班车", 					// 班次类型
				"line_title": "天颂雅苑-竹子林",		// 班次名称
				"line_remark": "很长的一条线路",		// 班线描述
				"time_range": "08:00-18:00",			// 发车区间
				"line_start_time": "08:00",				// 发车时间
				"start_site": "深大站",					// 始发站
				"end_site": "终点站",					// 终点站
				"bus_code": "B88888",					// 车牌号
				"line_contact": "李才敏 18923451241",	// 联系人及联系方式
				"line_rule": "休息日周六",				// 运行时间
				"line_price": "20元",					// 票价
				"status": "1",						//线路状态
				"dates" : ['2019-06-13','2019-06-20','2019-06-27']
				
				"sites": [
					{
						"site_id": 21,
						"site_name": "深大站",
						"site_lng": "站点经度",
						"site_lat": "站点纬度",
						"site_type": "1",
						"site_type_new": "1"
					}
				]
			}
	],
    "info": "成功"，
	"total_page": 1
}

# 班次站点状态

# 接口URL

  • 测试环境: http://apitest.dudubashi.com/index.php/api/open/line_site_status
  • 线上环境: http://wx.dudubashi.com/index.php/api/open/line_site_status

# 请求方法

post

名称 类型 说明 是否必须
token string 动态访问授权码 Y
line_id int 班次ID Y

# 返回参数

名称 类型 说明
result string 返回码 0000 成功 特殊码 12000:当日未运营 12001:班次已停运 12002:车辆无定位 12004:非运营时间
data array 数据
line_id int 班次ID
bus_status int 车辆状态 1 发车前，即暂未发车 ，2 已到始发站 ，3 离开始发站，即开始行程 ，4 到达终点站 5 离开终点，即行程结束
start_time string 发车时间
line_title string 班次名称
line_our_code string 线路编码
sites array 站点信息
site_id int 站点ID
site_name string 站点名称
bus_time string 车辆规划到站时间
bus_status int 站点车辆状态 0,1：未到站 ，2 已到站 ，3 离站，4 末班车已过站
info string 信息

# 返回数据示例(json格式)

{
	"result": "0000",
	"data": [
		{
			"line_id": 250542,
			"bus_status": 5,
			"start_time": "14:00",
			"line_title": "F区6号位(F区主干道6号位立牌处)-荔枝苑员工服务中心",
			"line_our_code": "F区-荔枝苑员工服务中心",
			"sites": [
				{
					"site_id": "384742",
					"site_name": "F区6号位(主干道立牌处",
					"bus_time": "10:00",
					"bus_status": 3
				},
				{
					"site_id": "384745",
					"site_name": "D区班车停靠区5号车位",
					"bus_time": "",
					"bus_status": 3
				},
				{
					"site_id": "384744",
					"site_name": "荔枝苑员工服务中心",
					"bus_time": "",
					"bus_status": 3
				}
			]
		}
	],
	"info": "成功"
}

# 退票

# 接口URL

  • 测试环境: http://apitest.dudubashi.com/index.php/api/open/refund_ticket
  • 线上环境: http://wx.dudubashi.com/index.php/api/open/refund_ticket

# 请求方法

post

名称 类型 说明 是否必须
token string 动态访问授权码 Y
order_id int 订单ID Y

# 返回参数

名称 类型 说明
result string 返回码 0000 成功
info string 信息

# 返回数据示例(json格式)

{
	"result": "0000",
	"info": "成功"
}

← 设置线路白名单 →