检索周边加油站
测试接口地址:http://www.ok619.com:8083/newapi/v1/gjjyz/services/station/around/{lng}/{lat}
正式接口地址:https://api.ok619.com/newapi/v1/gjjyz/services/station/around/{lng}/{lat}
返回格式:json
请求方式:post json 数据流
请求参数说明:
名称 |
必填 |
类型 |
说明 |
usercode |
是 |
String(32) |
油客网分配 |
timestamp |
是 |
String(20) |
时间戳,单位秒 |
sign |
是 |
String(100) |
签名,见安全规范 |
language |
否 |
String(20) |
返回加油站数据的语言编码,值为如下之一:zh-中文;en-英语;local-加油站所在国家本地语言(默认) |
maptype |
否 |
String(20) |
gaode-(默认,火星坐标系统/高德地图);baidu- 百度坐标 |
platformFlag |
否 |
String(1) |
是否支持智慧加油:1 只包含智慧加油;0 无限制(默认) |
{lng} |
是 |
String(20) |
URL参数,经纬度参数,经度 |
{lat} |
是 |
String(20) |
URL参数,经纬度参数,维度 |
返回参数说明:
名称 |
类型 |
说明 |
code |
String |
调用状态码 |
msg |
String |
返回调用说明 |
data |
Array |
返回结果集
|
JSON 返回示例:
{
"msg":"success!",
"code":"00",
"data":[
{
"station_name":"邵一运加油站",
"area_name":"北塔区",
"brand_code":"minying",
"address":"湖南省邵阳市北塔区魏源路与鱼苗场路交叉口向东南",
"coordinate":"111.46440161469,27.24492559648",
"area_layer":"001800050003",
"business":"邵一运加油站",
"service_name":"1,2",
"service_code":"洗手间,便利店",
"station_id":"1411437360",
"area_code":"422500",
"brand_name":"社会民营",
"language":"zh-CN",
"state_code":"0",
"state_name":"正常",
"payment_code":"1",
"payment_name":"现金支付",
"currency":"CNY",
"oil_code":"95#,98#",
"oil_name":"95#汽油,98#号汽油",
"oil_prices":"7.8,9.2",
"distance":34
},{
...
}
]
}
获取加油站明细
测试接口地址:http://www.ok619.com:8083/newapi/v1/gjjyz/services/station/detail/{id}
正式接口地址:https://api.ok619.com/newapi/v1/gjjyz/services/station/detail/{id}
返回格式:json
请求方式:post json 数据流
请求参数说明:
名称 |
必填 |
类型 |
说明 |
usercode |
是 |
String(32) |
油客网分配 |
timestamp |
是 |
String(32) |
时间戳,单位秒 |
sign |
是 |
String(128) |
签名,见安全规范 |
language |
否 |
String(20) |
返回加油站数据的语言编码,值为如下之一:zh-中文;en-英语;local-加油站所在国家本地语言(默认) |
{id} |
是 |
String |
URL参数,加油站的ID |
返回参数说明:
code |
String |
调用状态码 |
msg |
String |
返回调用说明 |
data |
Array |
返回结果集
|
JSON返回示例:
{
"msg":"success!",
"code":"00",
"data":[
{
"station_name":"邵一运加油站",
"area_name":"北塔区",
"brand_code":"minying",
"address":"湖南省邵阳市北塔区魏源路与鱼苗场路交叉口向东南",
"coordinate":"111.46440161469,27.24492559648",
"area_layer":"001800050003",
"business":"邵一运加油站",
"service_name":"1,2",
"service_code":"洗手间,便利店",
"station_id":"1411437360",
"area_code":"422500",
"brand_name":"社会民营",
"language":"zh-CN",
"state_code":"0",
"state_name":"正常",
"payment_code":"1",
"payment_name":"现金支付",
"currency":"CNY",
"oil_code":"95#,98#",
"oil_name":"95#汽油,98#号汽油",
"oil_prices":"7.8,9.2",
"distance":34
}
]
}
按地区获取加油站
测试接口地址:http://www.ok619.com:8083/newapi/v1/gjjyz/services/station/list/all/{country_code}/{area_code}
正式接口地址:https://api.ok619.com/newapi/v1/gjjyz/services/station/list/all/{country_code}/{area_code}
返回格式:json
请求方式:post json数据流
请求参数说明:
名称 |
必填 |
类型 |
说明 |
usercode |
是 |
String(32) |
油客网分配 |
timestamp |
是 |
String(32) |
时间戳,单位秒 |
sign |
是 |
String(128) |
签名,见安全规范 |
language |
否 |
String(20) |
返回加油站数据的语言编码,值为如下之一:zh-中文;en-英语;local-加油站所在国家本地语言(默认) |
pageSize |
是 |
String |
每页返回记录总数,最大50 |
pageIndex |
是 |
String |
查询页码 |
{country_code} |
是 |
String |
URL参数,指定返回指定国家数据 |
{area_code} |
否 |
String |
URL参数,地区编码,如果提供,那么返回指定地区数据 |
返回参数说明:
code |
String |
调用状态码 |
msg |
String |
返回调用说明 |
data |
Array |
返回结果集
|
JSON返回示例:
{
"msg":"success!",
"code":"00",
"totalCount":100,
"data":[
{
"station_name":"邵一运加油站",
"area_name":"北塔区",
"brand_code":"minying",
"address":"湖南省邵阳市北塔区魏源路与鱼苗场路交叉口向东南",
"coordinate":"111.46440161469,27.24492559648",
"area_layer":"001800050003",
"business":"邵一运加油站",
"service_name":"1,2",
"service_code":"洗手间,便利店",
"station_id":"1411437360",
"area_code":"422500",
"brand_name":"社会民营",
"language":"zh-CN",
"state_code":"0",
"state_name":"正常",
"payment_code":"1",
"payment_name":"现金支付",
"currency":"CNY",
"oil_code":"95#,98#",
"oil_name":"95#汽油,98#号汽油",
"oil_prices":"7.8,9.2",
"distance":34
},{...},{...},...
]
}
按地区获最近更新加油站
测试接口地址:http://www.ok619.com:8083/newapi/v1/gjjyz/services/station/list/update/{country_code}
正式接口地址:https://api.ok619.com/newapi/v1/gjjyz/services/station/list/update/{country_code}
返回格式:json
请求方式:post json 数据流
请求参数说明:
名称 |
必填 |
类型 |
说明 |
usercode |
是 |
String(32) |
油客网分配 |
timestamp |
是 |
String(32) |
时间戳,单位秒 |
sign |
是 |
String(128) |
签名,见安全规范 |
language |
否 |
String(20) |
返回加油站数据的语言编码,值为如下之一:zh-中文;en-英语;local-加油站所在国家本地语言(默认) |
pageSize |
是 |
String |
每页返回记录总数,最大50 |
pageIndex |
是 |
String |
查询页码 |
days |
否 |
Int |
返回最近指定天数内更新的加油站,默认为7,最大15 |
{country_code} |
是 |
String |
URL参数,指定返回指定国家数据 |
返回参数说明:
code |
String |
调用状态码 |
msg |
String |
返回调用说明 |
data |
Array |
返回结果集
|
JSON 返回示例:
{
"msg":"success!",
"code":"00",
"totalCount":100,
"data":[
{
"station_name":"邵一运加油站",
"area_name":"北塔区",
"brand_code":"minying",
"address":"湖南省邵阳市北塔区魏源路与鱼苗场路交叉口向东南",
"coordinate":"111.46440161469,27.24492559648",
"area_layer":"001800050003",
"business":"邵一运加油站",
"service_name":"1,2",
"service_code":"洗手间,便利店",
"station_id":"1411437360",
"area_code":"422500",
"brand_name":"社会民营",
"language":"zh-CN",
"state_code":"0",
"state_name":"正常",
"payment_code":"1",
"payment_name":"现金支付",
"currency":"CNY",
"oil_code":"95#,98#",
"oil_name":"95#汽油,98#号汽油",
"oil_prices":"7.8,9.2",
"distance":34
},{...},{...},...
]
}
获取已经删除的加油站id列表
测试接口地址:http://www.ok619.com:8083/newapi/v1/gjjyz/services/station/list/delete/{country_code}
正式接口地址:https://api.ok619.com/newapi/v1/gjjyz/services/station/list/delete/{country_code}
返回格式:json
请求方式:post json数据流
请求参数说明:
名称 |
必填 |
类型 |
说明 |
usercode |
是 |
String(32) |
油客网分配 |
timestamp |
是 |
String(32) |
时间戳,单位秒 |
sign |
是 |
String(128) |
签名,见安全规范 |
返回参数说明:
code |
String |
调用状态码 |
msg |
String |
返回调用说明 |
data |
Array |
返回结果集
|
JSON 返回示例:
{
"msg":"success",
"code":"0",
"data":["1411394643,1411394644,1411394724,1411394753,1411394757,1411394759,1411395002,1411395043,1411395048"]
}
获取地区列表
测试接口地址:http://www.ok619.com:8083/newapi/v1/gjjyz/services/region/list/{country_code}/{area_code}
正式接口地址:https://api.ok619.com/newapi/v1/gjjyz/services/region/list/{country_code}/{area_code}
返回格式:json
请求方式:post json 数据流
请求参数说明:
名称 |
必填 |
类型 |
说明 |
usercode |
是 |
String(32) |
油客网分配 |
timestamp |
是 |
String(32) |
时间戳,单位秒 |
sign |
是 |
String(128) |
签名,见安全规范 |
{country_code} |
是 |
String |
URL参数,指定返回指定国家数据 |
{area_code} |
否 |
String |
URL参数,地区编码,如果提供,那么返回指定地区数据 |
返回参数说明:
code |
String |
调用状态码 |
msg |
String |
返回调用说明 |
data |
Array |
返回结果集
|
JSON返回示例:
{
"msg":"success!",
"code":"00",
"data":[
{"name_zh":"北京市","code":"000","layer_code":"0001","name":"北京市"},
{"name_zh":"西城区","code":"xicheng","layer_code":"00010001","name":"西城区"},
{"name_zh":"宣武区","code":"xuanwu","layer_code":"00010003","name":"宣武区"},
{"name_zh":"朝阳区","code":"chaoyang","layer_code":"00010004","name":"朝阳区","name_en":"chao yang"},
{"name_zh":"海淀区","code":"haidian","layer_code":"00010005","name":"海淀区"}
]
}
获取地区指导价
测试接口地址:http://www.ok619.com:8083/newapi/v1/gjjyz/services/station/guidance/price/{country_code}/{area_code}
正式接口地址:https://api.ok619.com/newapi/v1/gjjyz/services/station/guidance/price/{country_code}/{area_code}
返回格式:json
请求方式:post json数据流
请求参数说明:
名称 |
必填 |
类型 |
说明 |
usercode |
是 |
String(32) |
油客网分配 |
timestamp |
是 |
String(32) |
时间戳,单位秒 |
sign |
是 |
String(128) |
签名,见安全规范 |
{country_code} |
是 |
String |
URL参数,指定返回指定国家数据 |
{area_code} |
否 |
String |
URL参数,地区编码,如果提供,那么返回指定地区数据 |
返回参数说明:
code |
String |
调用状态码 |
msg |
String |
返回调用说明 |
data |
Array |
返回结果集
|
JSON返回示例:
{
"msg":"success!",
"code":"00",
"data":[
{"oil_name":"92号汽油","oil_code":"92#"},
{"oil_name":"95号汽油","price":7,"price_pre":7.8,"oil_code":"95#"},
{"oil_name":"98号汽油","oil_code":"98#"},
{"oil_name":"天然气","oil_code":"CNG"}
]
}
获取国家列表
测试接口地址:http://www.ok619.com:8083/newapi/v1/gjjyz/services/country/list
正式接口地址:https://api.ok619.com/newapi/v1/gjjyz/services/country/list
返回格式:json
请求方式:post json数据流
请求参数说明:
名称 |
必填 |
类型 |
说明 |
usercode |
是 |
String(32) |
油客网分配 |
timestamp |
是 |
String(32) |
时间戳,单位秒 |
sign |
是 |
String(128) |
签名,见安全规范 |
返回参数说明:
code |
String |
调用状态码 |
msg |
String |
返回调用说明 |
data |
Array |
返回结果集
|
JSON返回示例:
{
"msg":"success!",
"code":"00",
"data":[
{"code":"764","name":"泰国","language":"th","currency":"th","name_en":"Thailand"},
{"code":"524","name":"尼泊尔","name_en":"Nepal"},
{"code":"887","name":"也门","name_en":"Yemen"}
]
}
获取字典
测试接口地址:http://www.ok619.com:8083/newapi/v1/gjjyz/services/dict/list/{country_code}/{visiontype}
正式接口地址:https://api.ok619.com/newapi/v1/gjjyz/services/dict/list/{country_code}/{visiontype}
返回格式:json
请求方式:post json数据流
请求参数说明:
名称 |
必填 |
类型 |
说明 |
usercode |
是 |
String(32) |
油客网分配 |
timestamp |
是 |
String(32) |
时间戳,单位秒 |
sign |
是 |
String(128) |
签名,见安全规范 |
{country_code} |
是 |
String |
URL参数,指定返回指定国家数据 |
{visiontype} |
否 |
String |
URL参数,字典类型,YQZL-加油站油气种类字典;JYZZT-加油站状态;DHZT-加油站电话状态;YZPP-加油站品牌字典;JYZFWLX-加油站提供服务类型;JYZ_PAYTYPE-加油站支付方式;currencycode-货币编码;langcode-语言编码 |
返回参数说明:
code |
String |
调用状态码 |
msg |
String |
返回调用说明 |
data |
Array |
返回结果集
|
JSON返回示例:
{
"msg":"success!",
"code":"00",
"data":[
{"name_zh":"正常营业","code":"1","name":"正常营业","name_en":"normal"},
{"name_zh":"暂停营业","code":"2","name":"暂停营业","name_en":"suspend"},
{"name_zh":"停业关闭","code":"3","name":"停业关闭","name_en":"stop"}
]
}