服务管理
创建服务
服务介绍
可以通过此请求,在对应的ak下增加1个service,service增加成功后会返回service的id。每个Key下最多注册15个service。
接口地址
https://lbs.navinfo.com/open-api/geofence/v1/track/service/add
请求方式
GET/POST
post请求参数需用x-www-form-urlencoded方式传输
请求参数
创建服务说明请参见下表:
参数名 | 类型 | 含义 | 是否必填 | 默认值 | 备注 |
---|---|---|---|---|---|
ak | string | 开发者密钥 | 是 | ||
name | string | service的名字, 名字在同一个Key下不可重复,不可为空 | 是 | 命名规则: 仅支持中文、英文大小字母、英文下划线"_"、英文横线"-"和数字,不能以"_"开头,最长不得超过128个字符。 | |
desc | string | 针对此 service 的文字描述,方便用户对 service 进行记忆。 | 否 | 仅支持中文、英文大小字母、英文下划线"_"、英文横线"-"和数字, 不能以"_"开头,最长不得超过128个字符。 |
响应数据
名称 | 类型 | 含义 | 备注 | |
---|---|---|---|---|
code | int | 结果状态码 | ||
message | string | 结果状态码描述 | ||
data | object | 返回的结果 | ||
service_id | int | 服务的唯一ID | ||
name | string | 服务名称 |
服务示例
删除服务
服务介绍
可以通过此请求,在对应的ak下删除存在service。
接口地址
https://lbs.navinfo.com/open-api/geofence/v1/track/service/delete
请求方式
GET/POST
post请求参数需用x-www-form-urlencoded方式传输
请求参数
删除服务说明请参见下表:
参数名 | 类型 | 含义 | 是否必填 | 默认值 | 备注 |
---|---|---|---|---|---|
ak | string | 开发者密钥 | 是 | ||
service_id | int | 创建服务时返回的服务Id | 是 |
响应数据
名称 | 类型 | 含义 | 备注 |
---|---|---|---|
code | int | 结果状态码 | |
message | string | 结果状态码描述 |
服务示例
修改服务
服务介绍
可以通过此请求,在对应的ak下修改service的信息。
接口地址
https://lbs.navinfo.com/open-api/geofence/v1/track/service/update
请求方式
GET/POST
post请求参数需用x-www-form-urlencoded方式传输
请求参数
修改服务说明请参见下表:
参数名 | 类型 | 含义 | 是否必填 | 默认值 | 备注 |
---|---|---|---|---|---|
ak | string | 开发者密钥 | 是 | ||
service_id | int | 创建服务时返回的服务ID | 是 | 注意:不可修改, 此参数用于查找service | |
name | string | 服务名称,可以修改 | 否 | 若指定此字段,但是没有填写内容则会将服务名称清空 | |
desc | string | 服务描述,可以修改 | 否 | 若指定此字段,但是没有填写内容则会将服务描述清空。 |
响应数据
名称 | 类型 | 含义 | 备注 | |
---|---|---|---|---|
code | int | 结果状态码 | ||
message | string | 结果状态码描述 | ||
data | object | 返回的结果 | ||
service_id | int | 服务的唯一ID | ||
name | string | 服务名称 | 修改后的服务名称 | |
desc | string | 服务描述 | 修改后的服务描述 |
服务示例
查询服务
服务介绍
可以通过此请求,查询对应ak下的service,每个ak下最多15个service, 无需分页。
接口地址
https://lbs.navinfo.com/open-api/geofence/v1/track/service/query
请求方式
GET/POST
post请求参数需用x-www-form-urlencoded方式传输
请求参数
查询服务说明请参见下表:
参数名 | 类型 | 含义 | 是否必填 | 默认值 | 备注 |
---|---|---|---|---|---|
ak | string | 开发者密钥 | 是 |
响应数据
名称 | 类型 | 含义 | 备注 | |
---|---|---|---|---|
code | int | 结果状态码 | ||
message | string | 结果状态码描述 | ||
data | object | 返回的结果 | ||
service_id | int | 服务的唯一ID | ||
name | string | 服务名称 | 修改前的服务名称 | |
desc | string | 服务描述 | 修改前的服务描述 |
服务示例