文档首页/ ISDP/ API参考/ API接口/ 作业对象管理/ 新增和更新作业对象（API名称：createOrUpdateSignSites）
更新时间：2024-07-22 GMT+08:00
查看PDF
分享

新增和更新作业对象（API名称：createOrUpdateSignSites）

功能介绍

用户需要创建或更新作业对象信息时，可以通过该接口进行创建或更新作业对象信息。作业对象信息包含作业对象位置编码、名称、经纬度、详细位置等。

相关接口

接口名称

调用说明

获取Token

调用该接口获取到Token，再调用其他接口时，需要在请求消息头中添加“Authorization”，其值即为Token。

查询项目信息（API名称：findPagedProjectList）

调用该接口获取项目编码。

创建检查单时，需要输入项目编码。

调用流程

图1 创建和更新作业对象流程

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

否

有效性：

  • 1-有效
  • 0-无效

当为0时，删除旧的数据，默认为0。

resource

int

否

来源：

  • 1-isdp+
  • 2-isdp du

响应参数

参数

类型

描述

stateCode

String

响应状态码：

  • 0-成功
  • 其他-失败

errorMessage

String

响应描述

result

List<Object>

响应结果内容List，数量对应入参的数量

signSiteCode

String

作业对象编码

status

int

返回状态：

  • 0-成功
  • 1-失败

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": "保存成功"
        }
    ]
}

状态码

状态码请参见状态码。

错误码

错误码请参见错误码。

父主题： 作业对象管理

相关文档