新增和更新作业对象(API名称:createOrUpdateSignSites)
功能介绍
用户需要创建或更新作业对象信息时,可以通过该接口进行创建或更新作业对象信息。作业对象信息包含作业对象位置编码、名称、经纬度、详细位置等。
相关接口
| 接口名称 | 调用说明 |
|---|---|
| 调用该接口获取到Token,再调用其他接口时,需要在请求消息头中添加“Authorization”,其值即为Token。 | |
| 调用该接口获取项目编码。 创建检查单时,需要输入项目编码。 |
调用流程
URL
| 请求方式 | HTTPS地址 | 服务架构 | 消息体类型 |
|---|---|---|---|
| POST | https://isdp+域名/openapi/v1/openTask/createOrUpdateSignSites | OpenAPI | application/json |
请求头
| KEY | VALUE | 是否必填 | 描述 |
|---|---|---|---|
| Content-Type | application/json | 是 | 无 |
| Authorization | bearer ${access_token} | 是 | bearer +“ ”+5.2.1中获取的access_token的值 |
请求参数
| 参数 | 类型 | 是否必填 | 描述 |
|---|---|---|---|
| locations | List<Object> | 是 | 位置列表 |
| signSiteCode | String | 是 | 作业对象编码 |
| signSiteName | String | 是 | 作业对象名称 |
| signSiteAddress | String | 否 | 作业对象详细地址,如果是新增的作业对象必填 |
| adminRegion | String | 是 | 行政区域,传入国家省份城市名称,如:中国-广东-深圳 |
| longitude | double | 否 | 经度 |
| latitude | double | 否 | 维度 |
| projectNo | String | 是 | 项目编码 获取项目编码API请参见:查询项目信息(API名称:findPagedProjectList) |
| projectName | String | 否 | 项目名称,项目需要新增时必填 |
| signSiteType | String | 否 | 作业对象类型 |
| valid | int | 否 | 有效性:
当为0时,删除旧的数据,默认为0。 |
| resource | int | 否 | 来源:
|
响应参数
| 参数 | 类型 | 描述 |
|---|---|---|
| stateCode | String | 响应状态码:
|
| errorMessage | String | 响应描述 |
| result | List<Object> | 响应结果内容List,数量对应入参的数量 |
| signSiteCode | String | 作业对象编码 |
| status | int | 返回状态:
|
| message | String | 返回的失败消息 |
| signSiteId | Long | 作业对象id,新增时返回 |
请求示例
{"locations":
[
{
"signSiteCode": "0811-我的作业对象",
"signSiteName": "0811-我的作业对象",
"signSiteType": "公交站",
"adminRegion": "中国-XX-XX",
"longitude": 23.1234564,
"latitude": 124.4514564564,
"signSiteAddress": "XX的作业对象详细地址9",
"projectNo": "0811-我的项目",
"projectName": "0811-我的项目",
"valid": 1,
"resource": 2
}
]
} 响应示例
{
"stateCode": "0",
"errorMessage": null,
"result": [
{
"signSiteCode": "0811-我的作业对象",
"signSiteId": 4270,
"status": "0",
"message": "保存成功"
}
]
} 状态码
状态码请参见状态码。
错误码
错误码请参见错误码。