新增和更新作业对象（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": "保存成功"
}
]
}
状态码
状态码请参见状态码。
错误码
错误码请参见错误码。
