产品介绍
地图任务 API 是通过 HTTPS 协议访问远程服务的接口,提供新建/查询地图的能力。
适用场景
父任务创建:创建地图任务
父任务删除
任务查询
父任务列表查询
任务中心列表查询
父任务资源查询
子任务详情查询
使用限制
详细的服务调用量限制可点我查阅。
使用说明
接收请求返回的数据(JSON或XML格式),参考返回参数文档解析数据。
如无特殊声明,接口的输入参数和输出数据编码全部统一为 UTF-8 编码方式。
1. 任务创建
请求地址
parameters代表的参数为“url 请求参数”,包括必填参数和可选参数。所有参数均使用字符"&"进行分隔。下面的列表枚举了这些参数及其使用规则。
url 请求参数
参数名 | 含义 | 规则说明 | 参数类型 | 是否必须 | 缺省值 |
key | 高德Key | 用户在高德地图官网申请Web服务API类型Key | string | 必填 | 无 |
bizToken | 工作地图身份token | 用户申请的工作地图身份token,一个企业一个token | string | 必填 | 无 |
openId | 当前操作人 | 高德用户的开放id | string | 必填 | 无 |
sig | 数字签名 | 请参考数字签名获取和使用方法 | string | 非必填 | 无 |
bizSign | 业务签名 | 签名参数:openId、bizToken (参考签名规则) | string | 必填 | 无 |
workMapId | 高德工作地图id |
| string | 必填 | 无 |
workTaskCenterName | 任务名称 |
| string | 必填 | 无 |
workTaskCenterDesc | 任务描述 |
| string | 非必填 | 无 |
workTaskCenterExecutorId | 执行人 |
| string | 必填 | 无 |
workTaskCenterBeginTime | 开始时间 | 时间戳 | long | 必填 | 无 |
workTaskCenterEndTime | 结束时间 | 时间戳 | long | 必填 | 无 |
workTaskCenterType | 任务类型 | 1- 普通任务 2-周期任务 | int | 必填 | 无 |
workTaskCenterPeriod | 任务周期提醒 | {"periodType":1,"periodFreq":1,"periodInterval":1,"periodNum":1,"skipHoliday":1,"skipWeekend":1,"endType":1,"endCount":3,"endTime":"2024-09-12 13:15:20"} 详细说明见 : 附件 | string | 非必填 | 无 |
workTaskCenterNotify | 任务提醒类型 | [{"workTaskNotifyType":3}] 详细说明见 : 附件 | string | 非必填 | 无 |
resourceIdList | 资源Id集合 |
| List<String> | 必填 | 无 |
workTaskCenterRuleList | 任务达成条件集合 | [{"workTaskRuleType":1,"workTaskRuleRemark":"需要完成打卡哦"},{"workTaskRuleType":2,"workTaskRuleRemark":"需要进行任务反馈哦"}] 详细说明见 : 附件 | string | 非必填 | 无 |
workTaskCenterSceneType | 任务场景类型 | 1-普通 2-智能调度 3-排程 | int | 必填 | 无 |
routePlanningFlag | 路线规划标识 | 1-不规划 2-规划 | int | 非必填 | 1 |
imageUrls | 图片url 信息 |
| List<String> | 非必填 |
|
workTaskCenterBeginType | 开始类型 | 1 自动开始 2 手动开始 | int | 必填 |
|
返回参数
响应结果的格式为 JSON 形式。
以下是返回参数说明:
名称 | 含义 | 参数说明 | 规则说明 |
code | 返回结果状态值 | number | 返回值为1 表示请求成功,其他情况表示失败。 |
message | 返回状态说明 | string | 当 status 为 0 时,message 会返回具体错误原因,否则返回“Successful”。详情可以参阅info状态表 |
timestamp | 服务时间戳 | number |
|
data | 返回结果数据 | string | 任务id(workTaskCenterId) |
2、任务创建(新增电子围栏)
请求地址:
url 请求参数
参数名 | 参数类型 | 含义 | 规则 | 示例值 | 是否必填 |
key | String | 高德Key | 用户在高德地图官网申请Web服务API类型Key |
| 必填 |
bizToken | String | 工作地图身份token | 用户申请的工作地图身份token,一个企业一个token |
| 必填 |
openId | String | 当前操作人 | 高德用户的开放id |
| 必填 |
sig | String | 数字签名 | 请参考数字签名获取和使用方法 |
| 选填 |
bizSign | String | 业务签名 | 签名参数openId,bizToken(参考签名规则) |
| 必填 |
body请求参数
参数名 | 参数类型 | 含义 | 规则 | 示例值 | 是否必填 |
workMapId | string | 工作地图Id |
| P3AOnftSzq7bdMTxw057S | 必填 |
workTaskCenterName | string | 任务名称 |
| 测试任务 | 必填 |
workTaskCenterDesc | string | 任务描述 |
| 测试任务 | 非必填 |
workTaskCenterExecutorId | string | 执行人 | 执行人的openId | - | 必填 |
workTaskCenterBeginTime | number | 开始时间 | 当workTaskCenterBeginType = 1 时 ,必填 | 时间戳 | 非必填 |
workTaskCenterEndTime | number | 截止时间 |
| 时间戳 | 非必填 |
workTaskCenterType | number | 任务类型 | 1- 普通任务 2- 周期任务 | 1 | 必填 |
workTaskCenterPeriod | string | 任务周期提醒 | 详细说明见 : 附件 | {"periodType":1,"periodFreq":1,"periodInterval":1,"periodNum":1,"skipHoliday":1,"skipWeekend":1,"endType":1,"endCount":3,"endTime":"2024-09-12 13:15:20"} | 必填 |
workTaskCenterNotify | string | 任务提醒类型 | 详细说明见 : 附件 | [{"workTaskNotifyType":3}] | 非必填 |
resourceListStr | string | 资源Id集合 | 资源点不能超过50, 详细说明见 : 附件 | [{"resourceId":"2003003712445027","beginTime":1702899563823,"endTime":1702985963000}] | 必填 |
workTaskCenterRuleList | string | 任务达成条件集合 | 详细说明见 : 附件 | [{"workTaskRuleType":1,"workTaskRuleRemark":"需要完成签到打卡哦"},{"workTaskRuleType":2,"workTaskRuleRemark":"需要进行任务反馈哦","subRuleList":[{"workTaskSubRuleId":"12000044568007"}]},{"workTaskRuleType":2,"workTaskRuleRemark":"需要进行任务反馈哦(无表单)"]},{"workTaskRuleType":3,"workTaskRuleRemark":"需要进行签退打卡哦"},{"workTaskRuleType":4,"workTaskRuleRemark":"需要进行编辑地点哦","subRuleList":[{"workTaskSubRuleId":"1"},{"workTaskSubRuleId":"2"}]}] | 非必填 |
workTaskCenterSceneType | number | 任务场景类型 | 1-普通 2-智能调度 3-排程 |
| 必填 |
fenceSwitch | number | 电子围栏开关 | 1 关闭 2 打开 | - | 必填 |
fenceScope | number | 电子围栏范围 | 当fenceSwitch 为2 的时候必填 | - | 非必填 |
imageUrls | Array | 图片url 信息 |
| - | 非必填 |
workTaskCenterBeginType | Number | 开始类型 | 1 自动开始 2 手动开始 |
| 必填 |
返回参数
响应结果的格式为 JSON 形式,以下是参数说明
参数名 | 含义 | 参数类型 | 规则说明 |
data |
| 返回结果数据 | Object |
|
| workTaskCenterId |
| String |
|
code | 返回结果状态值 | Number |
|
message | 返回状态说明 | String | 成功时返回Successful,否则返回错误原因 |
result | 结果 | Boolean | true或false |
version | 版本信息 | String |
|
timestamp | 时间戳 | Number |
|
requestId | 请求id | String |
|
返回示例
{
"data": {
"workTaskCenterId":"500820330871010",
},
"code": 1,
"message": "Successful",
"result": true,
"version": "1.0",
"timestamp": 1701142286019,
"requestId": "1eb5d12017011422856761177d14ca"
}
3. 父任务删除
请求地址
请求参数
参数名 | 含义 | 规则说明 | 参数类型 | 是否必填 | 缺省值 |
key | 请求服务权限标识 | 用户在高德地图官网申请Web服务API类型KEY | string | 是 | 无 |
openId | 高德开放用户id | 操作人在高德的身份id | string | 是 | 无 |
workMapId | 地图id | - | string | 是 | 无 |
workTaskCenterIds | 要删除的父任务id | 半角逗号分隔的字符串格式 | string | 是 | 无 |
bizToken | 工作地图身份token | 用户申请的工作地图身份token,一个组织一个token | string | 是 | 无 |
bizSign | 业务签名 | 签名参数:workMapId, openId(参考签名规则) | string | 是 | 无 |
返回参数
返回字段 | 含义 | 规则说明 |
code | 返回结果编码 | 1 表示成功 |
message | 返回状态说明 | 成功时返回Successful,否则返回错误原因 |
version | 版本号 | 字符串类型 |
timestamp | 时间戳 | Unix 时间戳,参考文档:《Unix 时间戳》 |
requestId | requestId是RPC链路的全局唯一标识,排查问题时需要提供 | 字符串格式,长度30 |
附表
0、异常 |
1、成功 |
2、失败 |
3、参数错误 |
1001、权限不足:『不是地图成员』,或『不是任务创建人且不是管理员』 |
4. 父任务详情
请求地址
parameters代表的参数为“url 请求参数”,包括必填参数和可选参数。所有参数均使用字符"&"进行分隔。下面的列表枚举了这些参数及其使用规则。
url 请求参数
参数名 | 含义 | 规则说明 | 参数类型 | 是否必须 | 缺省值 |
key | 高德Key | 用户在高德地图官网申请Web服务API类型Key | string | 必填 | 无 |
bizToken | 工作地图身份token | 用户申请的工作地图身份token,一个企业一个token | string | 必填 | 无 |
openId | 当前操作人 | 高德用户的开放id | string | 必填 | 无 |
sig | 数字签名 | 请参考数字签名获取和使用方法 | string | 必填 | 无 |
bizSign | 业务签名 | 签名参数:openId、bizToken (参考签名规则) | string | 必填 | 无 |
workMapId
| 工作地图id
|
| string
| 必填 | 无
|
workTaskCenterId
| 任务id
|
| string
| 必填 | 无
|
返回参数
响应结果的格式为 JSON 形式。
以下是返回参数说明:
名称 | 含义 | 参数说明 | 规则说明 |
code | 返回结果状态值 | number | 返回值为1 表示请求成功,其他情况表示失败。 |
message | 返回状态说明 | string | 当 status 为 0 时,message 会返回具体错误原因,否则返回“Successful”。详情可以参阅info状态表 |
timestamp | 服务时间戳 | number |
|
data | 返回结果数据 | object | 结果对象,包括下述字段: |
| routePlanningFlag | 是否可以顺路规划 | int |
|
workMapId | 工作地图id | string |
|
workTaskCenterBeginTime | 任务开始时间 | long |
|
workTaskCenterCreateUserAvatar | 用户头像 | string |
|
workTaskCenterCreateUserId | 创建人openId | string |
|
workTaskCenterCreateUserName | 创建人 | string |
|
workTaskCenterDesc | 任务描述 | string |
|
workTaskCenterEndTime | 任务结束时间 | long |
|
workTaskCenterExecutionStatus | 执行状态 | int | 0 - "执行中" 1 - "完成" 2 - "待开始" 3 - "已逾期" |
workTaskCenterExecutorAvatar | 执行人头像 | string |
|
workTaskCenterExecutorId | 执行人openId | string |
|
workTaskCenterExecutorName | 执行人名称 | string |
|
workTaskCenterId | 任务ID | string |
|
workTaskCenterName | 任务名称 | string |
|
workTaskCenterNotifyList | 通知列表 | List<workTaskCenterNotifyList> |
|
workTaskCenterNotifyList | workTaskNotifyId | 通知id |
|
workTaskNotifyType | int | 1 - 不提醒 2-任务开始时提醒 3-任务开始前5分钟 4-任务开始前15分钟 5-任务开始前30分钟 6-任务截止前一天 |
| workTaskCenterPeriod | 提醒规则 | WorkTaskCenterPeriod |
|
WorkTaskCenterPeriod | periodType | int | 选择类型: 1-不重复 2-每天重复 3-每周重复 4-每月重复 5-自定义重复 |
periodFreq | int | 重复周期类型: 1- 按天 2-按周 3-按月 4-按年 |
periodInterval | int | 重复频次:从1开始 例子 : 每()天,每()周 这里代表括号里的数字 |
periodNum | int | 重复时间 例子:选择按周 这里代表的是: 1:周一,2:周二 以此类推 |
endType | int | 重复截止类型: 1-一直重复 2-按时间结束重复 3-按次数结束重复 |
endCount | int | 重复截止次数: 例子:选择按次数结束 这里的意思:执行了3次结束 |
endTime | String | 重复截止时间 "2024-09-12 13:15:20" |
skipHoliday | int | 是否跳过法定节假日 1-否 2-是 |
skipWeekend | int | 是否跳过双休日 1-否 2-是 |
| workTaskCenterRuleList | 规则列表 | List<WorkTaskCenterRule> |
|
WorkTaskCenterRule
| workTaskRuleId | string | 规则id |
workTaskRuleRemark | string | 规则说明 |
workTaskRuleType | int | 规则类型 1-打卡 2-评论 |
| workTaskCenterSceneType | 任务场景类型 | int | 1-普通 2-智能调度 3-排程 |
workTaskCount | 任务数量 | int |
|
workTaskFinishCount | 完成任务数量 | int |
|
5. 任务中心列表
请求地址
parameters代表的参数为“url 请求参数”,包括必填参数和可选参数。所有参数均使用字符"&"进行分隔。下面的列表枚举了这些参数及其使用规则。
url 请求参数
参数名 | 含义 | 规则说明 | 参数类型 | 是否必须 | 缺省值 |
key | 高德Key | 用户在高德地图官网申请Web服务API类型Key | string | 必填 | 无 |
bizToken | 工作地图身份token | 用户申请的工作地图身份token,一个企业一个token | string | 必填 | 无 |
openId | 当前操作人 | 高德用户的开放id | string | 必填 | 无 |
sig | 数字签名 | 请参考数字签名获取和使用方法 | string | 必填 | 无 |
bizSign | 业务签名 | 签名参数:openId、bizToken (参考签名规则) | string | 必填 | 无 |
workMapId
| 工作地图id
|
| string
| 必填
| 无
|
queryType | 查询任务类型 | 查询任务类型 1: 我执行的 2: 我创建的 默认全部 | int | 非必填 | 无 |
taskStatusList | 任务状态 | 0 - "执行中" 1 - "完成" 2 - "完成" | List<string> | 非必填 | 无 |
memberIds | 执行人 |
| List<string> | 非必填 | 无 |
dataTimeType | 时间类型 | 1. 创建时间、2. 开始时间、3. 截止时间、4. 完成时间 | int | 非必填 | 无 |
startTime | 开始时间 | 时间戳 | long | 非必填 | 无 |
endTime | 结束时间 | 时间戳 | long | 非必填 | 无 |
sortType | 排序方式 | 1. 按截止时间最近 2. 按开始时间最早 3. 按开始时间最晚 | int | 必填 | 无 |
token | 游标id |
| string | 非必填 | 无 |
size | 每页大小 |
| int | 必填 | 无 |
返回参数
响应结果的格式为 JSON 形式。
以下是返回参数说明:
名称 | 含义 | 参数说明 | 规则说明 |
code | 返回结果状态值 | number | 返回值为1 表示请求成功,其他情况表示失败。 |
message | 返回状态说明 | string | 当 status 为 0 时,message 会返回具体错误原因,否则返回“Successful”。详情可以参阅info状态表 |
timestamp | 服务时间戳 | number |
|
data | 返回结果数据 | object | 结果对象,包括下述字段: |
| token | 游标id | string |
|
count | 查询数量 | int |
|
resultDTOList | 返回数据 | List<ListWorkTaskCenterResultDTO> |
|
ListWorkTaskCenterResultDTO | workTaskCenterCreateUserId | string | 创建人openId |
workTaskCenterCreateUserName | string | 创建人名称 |
workTaskCenterBeginTime number | long | 任务开始时间 |
workTaskCenterEndTime | long | 任务截止时间 |
workTaskCenterExecutionStatus | int | 0 - "执行中" 1 - "完成" 2 - "待开始" 3 - "已逾期" |
workTaskCenterExecutorId | string | 任务执行人id |
workTaskCenterExecutorName | string | 任务执行人名称 |
workTaskCenterExecutorAvatar | string | 执行人头像 |
workTaskCenterDesc | string | 任务描述 |
workTaskCenterId | string | 任务id |
workTaskCenterName | string | 任务名称 |
workTaskCount number | int | 子任务总数量 |
workTaskFinishCount | int | 子任务完成的数量 |
workTaskCenterExecutorMobile | string | 任务执行人手机号 |
6. 父任务资源列表
请求地址
parameters代表的参数为“url 请求参数”,包括必填参数和可选参数。所有参数均使用字符"&"进行分隔。下面的列表枚举了这些参数及其使用规则。
url 请求参数
参数名 | 含义 | 规则说明 | 参数类型 | 是否必须 | 缺省值 |
key | 高德Key | 用户在高德地图官网申请Web服务API类型Key | string | 必填 | 无 |
bizToken | 工作地图身份token | 用户申请的工作地图身份token,一个企业一个token | string | 必填 | 无 |
openId | 当前操作人 | 高德用户的开放id | string | 必填 | 无 |
sig | 数字签名 | 请参考数字签名获取和使用方法 | string | 必填 | 无 |
bizSign | 业务签名 | 签名参数:openId、bizToken (参考签名规则) | string | 必填 | 无 |
workMapId
| 工作地图id
|
| string
| 必填 | 无
|
workTaskCenterId
| 任务id
|
| string
| 必填 | 无
|
pageSize | 每页数量 | 50 | int | 必填 | 无
|
pageNumber | 页码 |
| int | 必填 | 无
|
返回参数
响应结果的格式为 JSON 形式。
以下是返回参数说明:
名称 | 含义 | 参数说明 | 规则说明 |
code | 返回结果状态值 | number | 返回值为1 表示请求成功,其他情况表示失败。 |
message | 返回状态说明 | string | 当 status 为 0 时,message 会返回具体错误原因,否则返回“Successful”。详情可以参阅info状态表 |
timestamp | 服务时间戳 | number |
|
data | 返回结果数据 | object | 结果对象,包括下述字段: |
| hasMore | 是否还有数据 | int | 0-没有 1-有 |
currentPage | 当前页码 | int |
|
resourceList | 资源集合 | List<OpenTaskCenterResourceListDTO> |
|
OpenTaskCenterResourceListDTO | resourceId | string | 资源Id |
subResourceId | string | 子资源Id |
resourceType | int | 资源类型: 4-点 6-面 |
resourceName | string | 资源名称 |
resourceColor | string | 资源颜色 |
approvalStatus | int | 资源的违规状态: 0-未审核 1-通过 2-违规 |
modifiedTime | string | 修改时间 |
iconOutline | string | 点自定义扎标边框 |
iconFiller | string | 点自定义扎标填充物 |
iconFillerInfo | WiaIconFillerDTO | 见附件:WiaIconFillerDTO |
showImageSwitch | string | 0-不展示 1-展示 |
imageList | List<String> | image列表 |
categoryId | string | 图层id |
poiSecretType | int | 涉密类型: -1-不涉密,无限制 1-禁止扎点 2-可扎点,不可编辑 3-非法名称 |
sortNum | int | 资源排序 |
workTaskId | string | 子任务id |
workTaskFinishStatus | int | 0 - "执行中" 1 - "完成" 2 - "待开始" 3 - "已逾期" |
resourceStatus | int | 0-已删除 1-已上线 |
workMissionId | string | 资源关系id(资源id 暂时无用) |
haveAuth | bool | 是否有权限 |
7. 子任务内容详情
请求地址
parameters代表的参数为“url 请求参数”,包括必填参数和可选参数。所有参数均使用字符"&"进行分隔。下面的列表枚举了这些参数及其使用规则。
url 请求参数
参数名 | 含义 | 规则说明 | 参数类型 | 是否必须 | 缺省值 |
key | 高德Key | 用户在高德地图官网申请Web服务API类型Key | string | 必填 | 无 |
bizToken | 工作地图身份token | 用户申请的工作地图身份token,一个企业一个token | string | 必填 | 无 |
openId | 当前操作人 | 高德用户的开放id | string | 必填 | 无 |
sig | 数字签名 | 请参考数字签名获取和使用方法 | string | 必填 | 无 |
bizSign | 业务签名 | 签名参数:openId、bizToken (参考签名规则) | string | 必填 | 无 |
workMapId
| 工作地图id
|
| string
| 必填 | 无
|
workTaskId
| 子任务id
|
| string
| 必填 | 无
|
返回参数
响应结果的格式为 JSON 形式。
以下是返回参数说明:
名称 | 含义 | 参数说明 | 规则说明 |
code | 返回结果状态值 | number | 返回值为1 表示请求成功,其他情况表示失败。 |
message | 返回状态说明 | string | 当 status 为 0 时,message 会返回具体错误原因,否则返回“Successful”。详情可以参阅info状态表 |
timestamp | 服务时间戳 | number |
|
data | 返回结果数据 | object | 结果对象,包括下述字段: |
| mapTaskVO | 任务信息详情 | OpenWorkTaskDTO |
|
OpenWorkTaskDTO | workTaskId | string | 子任务id |
workTaskEndTime
| long | 子任务截止时间 |
executeStatus | int | 子任务执行状态: 0 - "执行中" 1 - "完成" 2 - "待开始" 3 - "已逾期" |
workTaskName | string | 子任务名称 |
workTaskDesc | string | 子任务描述 |
workMissionId | string | 资源关系id(资源id 暂时无用) |
taskApprovalStatus | int | 0-未审核 1-通过 2-违规 |
workTaskCenterId | string | 父任务id |
| resourceVO | 资源详情 | OpenTaskResourceDTO |
|
OpenTaskResourceDTO | resourceId | string | 资源Id |
resourceName
| string | 资源名称 |
resourceColor | string | 资源颜色 |
iconOutline | string | 点自定义扎标边框 |
iconFiller | string | 点自定义扎标填充物 |
iconFillerInfo | WiaIconFillerDTO | 填充物详情 见附件:WiaIconFillerDTO |
poiSecretType | int | 涉密类型: -1-不涉密,无限制 1-禁止扎点 2-可扎点,不可编辑 3-非法名称 |
resourceType | int | 资源类型: 4-点 6-面 |
approvalStatus | int | 资源的违规状态: 0-审核中 1-通过 2-违规 |
| workTaskRuleInfoList | 任务规则信息列表 | List<OpenTaskRuleInfoDTO> |
|
OpenTaskRuleInfoDTO | workTaskRuleId | string | 规则id |
workTaskRuleType
| int | 规则类型 :1打卡 2评论 |
workTaskRuleRemark | string | 规则备注 |
workTaskEntityId | string | 任务id |
workTaskRuleRecordId | string | 规则记录id。 完成规则的时候需要用到 |
operateStatus | int | 规则完成状态:1未完成 2完成 |
operateTime | date | 完成规则操作时间 |
feedbackInfo | MapTaskFeedbackInfoDTO | 任务反馈 见附件:MapTaskFeedbackInfoDTO |
punchingCardInfo | MapTaskPunchingCardInfoDTO | 打卡信息 见附件:MapTaskPunchingCardInfoDTO |
8、查询任务资源快照信息
请求地址:
url 请求参数
参数名 | 参数类型 | 含义 | 规则 | 示例值 | 是否必填 |
key | String | 高德Key | 用户在高德地图官网申请Web服务API类型Key |
| 必填 |
bizToken | String | 工作地图身份token | 用户申请的工作地图身份token,一个企业一个token |
| 必填 |
openId | String | 当前操作人 | 高德用户的开放id |
| 必填 |
sig | String | 数字签名 | 请参考数字签名获取和使用方法 |
| 选填 |
bizSign | String | 业务签名 | 签名参数openId,bizToken(参考签名规则) |
| 必填 |
body请求参数
参数名 | 参数类型 | 含义 | 规则 | 示例值 | 是否必填 |
workMapId | String | 工作地图Id |
| P3AOnftSzq7bdMTxw057S | 必填 |
workTaskCenterId | String | 父任务id |
| - | 必填 |
pageNum | Number | 页码 |
| 2 | 必填 |
pageSize | Number | 单页显示条数 | 最大支持100 | 50 | 必填 |
返回参数
响应结果的格式为 JSON 形式,以下是参数说明
参数名 |
| 含义 | 参数类型 | 规则说明 |
data | 返回结果数据 | Object |
|
| currentPage | 当前页码 | Number |
|
| hasMore | 是否有更多 | Number | 1 有 0没有 |
| resourceCommentList | 资源评论列表 | Array |
|
|
| workTaskCenterId | 父任务id | String |
|
|
| workTaskId | 子任务id | String |
|
|
| resourceId | 资源id | String |
|
|
| commentId | 评论id | String |
|
|
| content | 评论内容 | String |
|
|
| imageUrlList | 评论图片列表 | Array |
|
|
| commentUserId | 评论者id | String |
|
|
| commentUserNickName | 评论者昵称 | String |
|
|
| commentUserAvatar | 评论者图像挂件 | String |
|
|
| commentTime | 评论时间 | Number |
|
|
| commentTypeDesc | 评论类型描述 | String |
|
|
| commentType | 评论类型 | Number |
|
code | 返回结果状态值 | Number |
|
message | 返回状态说明 | String | 成功时返回Successful,否则返回错误原因 |
result | 结果 | Boolean | true或false |
version | 版本信息 | String |
|
timestamp | 时间戳 | Number |
|
requestId | 请求id | String |
|
返回示例
{
"data": {
"resourceCommentList": [
{
"workTaskCenterId": "500300371824006",
"workTaskId": "4003003711050007",
"resourceId": null,
"commentId": "7f209bd7cd70300371",
"content": "编辑了位置「测试资源点231215」",
"imageUrlList": null,
"commentUserId": "70300371",
"commentUserNickName": "陆小果",
"commentUserAvatar": "http://img-cdn-test.amap.com/pp/avatar/b2f/3a/e3/70300371.jpeg?ver=1698826935&imgoss=1",
"commentTime": 1702620006022,
"commentTypeDesc": "编辑位置",
"commentType": 6
}
],
"currentPage": 1,
"hasMore": 0
},
"code": 1,
"message": "Successful",
"result": true,
"version": "1.0",
"timestamp": 1702620049500,
"requestId": "0b7b2fe417026200491857203d2269"
}
9、查询任务评论信息
请求地址:
url 请求参数
参数名 | 参数类型 | 含义 | 规则 | 示例值 | 是否必填 |
key | String | 高德Key | 用户在高德地图官网申请Web服务API类型Key |
| 必填 |
bizToken | String | 工作地图身份token | 用户申请的工作地图身份token,一个企业一个token |
| 必填 |
openId | String | 当前操作人 | 高德用户的开放id |
| 必填 |
sig | String | 数字签名 | 请参考数字签名获取和使用方法 |
| 选填 |
bizSign | String | 业务签名 | 签名参数openId,bizToken(参考签名规则) |
| 必填 |
body请求参数
参数名 | 参数类型 | 含义 | 规则 | 示例值 | 是否必填 |
workMapId | String | 工作地图Id |
| P3AOnftSzq7bdMTxw057S | 必填 |
workTaskCenterId | String | 父任务id |
| - | 必填 |
pageNum | Number | 页码 |
| 2 | 必填 |
pageSize | Number | 单页显示条数 | 最大支持100 | 50 | 必填 |
返回参数
响应结果的格式为 JSON 形式,以下是参数说明
参数名 |
| 含义 | 参数类型 | 规则说明 |
data | 返回结果数据 | Object |
|
| currentPage | 当前页码 | Number |
|
| hasMore | 是否有更多 | Number | 1 有 0没有 |
| resourceSnapshotList | 资源快照列表 | Array |
|
|
| workTaskCenterId | 父任务id | String |
|
|
| workTaskId | 子任务id | String |
|
|
| resourceId | 资源id | String |
|
|
| gmtCreate | 快照创建时间 | String |
|
|
| resourceGmtCreate | 资源创建时间 | String |
|
|
| resourceCreateOpenId | 资源创建人id | String |
|
|
| resourceCreateNickName | 资源创建人昵称 | String |
|
|
| resourceGmtModified | 资源修改时间 | String |
|
|
| resourceModifiedOpenId | 资源修改人id | String |
|
|
| resourceModifiedNickName | 资源修改人昵称 | String |
|
|
| lon | 经度 | String |
|
|
| lat | 纬度 | String |
|
|
| address | 资源地址 | String |
|
code | 返回结果状态值 | Number |
|
message | 返回状态说明 | String | 成功时返回Successful,否则返回错误原因 |
result | 结果 | Boolean | true或false |
version | 版本信息 | String |
|
timestamp | 时间戳 | Number |
|
requestId | 请求id | String |
|
返回示例
{
"data": {
"resourceSnapshotList": [
{
"workTaskCenterId": "500300371824006",
"workTaskId": "4003003711050007",
"resourceId": "2003003712445027",
"gmtCreate": 1702610897000,
"resourceGmtCreate": 1699251449067,
"resourceCreateUid": "70300371",
"resourceCreateNickName": "陆小果",
"resourceGmtModified": 1699251449067,
"resourceModifiedUid": "70300371",
"resourceModifiedNickName": "陆小果",
"lon": "116.43144384026526",
"lat": "40.022614531933975",
"address": "北京市朝阳区来广营西路99号"
}
],
"currentPage": 1,
"hasMore": 0
},
"code": 1,
"message": "Successful",
"result": true,
"version": "1.0",
"timestamp": 1702611474016,
"requestId": "1eb5d10417026114736441004d18c9"
}
10、任务反馈表单查询
请求地址
url请求参数
名称 | 类型 | 描述 | 规则 | 是否必填 |
key | string | 高德key | 用户在高德地图官网申请Web服务API类型Key | 是 |
openId | string | 当前操作人 | 高德用户的开放id | 是 |
bizToken | string | 工作地图身份token | 用户申请的工作地图身份token,一个企业一个token | 是 |
bizSign | string | 业务签名 | 签名参数 workMapId openId (参考签名规则) | 是 |
sig | string | 数字签名 | 请参考数字签名获取和使用方法 | 否 |
workMapId | String | 工作地图id |
| 是 |
请求参数
名称 | 类型 | 描述 | 规则 | 是否必填 |
pageNum | Number | 页码 | 默认1 |
|
pageSize | Number | 每页条数 | 默认20 |
|
返回参数
名称 | 类型 | 描述 | 规则说明 |
code | Number | 返回结果状态 |
|
data | Object | 返回结果数据 |
|
|
total | Number | 数据总量 |
|
|
hasMore | Number | 1表示还有下一页0没有下一页 |
|
| templates | Array | 反馈表单集合 |
|
|
| templateName | String | 模版名称 |
|
|
| templateId | String | 模版id |
|
|
| effectiveType | Number | 类型 |
|
message | String | 返回状态说明 | 成功时返回Successful,否则返回错误原因 |
result | Boolean | 返回结果状态 | true或false |
version | String | 版本 |
|
timestamp | Long | 时间戳 |
|
requestId | String | 请求id |
|
附件
WiaIconFillerDTO
名称 | 含义 | 参数说明 | 规则说明 |
iconFillerId | 填充物id | string | 模版类型id=value,文本/图片类型id为服务在扎标配置接口生成 |
iconFillerShowType | 填充物展示类 | int | 1-文本 2,-图片
3-模版 |
iconFillerValue | 填充内容 | string |
|
MapTaskFeedbackInfoDTO
名称 | 含义 | 参数说明 | 规则说明 |
imageUrls | image列表 | List<String> |
|
comment | 评论 | string |
|
approvalStatus | 审核状态 | string | 0-审核中 1-通过 2-违规 |
MapTaskPunchingCardInfoDTO
名称 | 含义 | 参数说明 | 规则说明 |
id | 打卡业务id | long |
|
punchingCardTime | 打卡时间 | long | 时间戳 |
punchingCardName | 打开名称 | string |
|
geographyName | 地点名称 | string |
|
comment
| 评论 | string |
|
imageUrls | 图片链接 | List<String> |
|
approvalStatus | 审核状态 |
| 0-审核中 1-通过 2-违规 |
workTaskCenterPeriod 参数详细说明
参数名 | 类型 | 含义 | 规则 | 是否必填 |
periodType | number | 提醒重复类型 | 1-不重复 2-每天重复 3-每周重复 4-每月重复 5-自定义重复 | 必填 |
periodFreq | number | 提醒频率 | 1-每天 2-每周 3-每月 | 当periodType为5时必填 |
periodInterval | number | 提醒时间间隔 | 例如:填提醒频率为1,此参数为3, 任务提醒为每3天提醒一次 | 当periodType为5时必填 |
periodNum | number | 提醒的日期 | 当periodFreq=2时 1-星期一 2-星期二 以此类推 当periodFreq=3时 1-每月1号 2-每月2号 以此类推 例如:填提醒频率为2,时间间隔为2,此参数为1,任务提醒为每2周的周一进行任务提醒 | 当periodFreq=3/2的时候必填 |
skipHoliday | number | 提醒是否跳过节假日 | 1-否 2-是 | 非必填 |
skipWeekend | number | 提醒是否跳过周末 | 1-否 2-是 | 非必填 |
endType | number | 提醒结束类型 | 1-一直重复 2-按日期结束重复 3-按次数结束重复 | 当periodType为5时必填 |
endCount | number | 提醒结束次数 |
| 当endType为2时必填 |
endTime | number | 提醒结束时间 | 传日时间戳 | 当endType为3时必填 |
workTaskCenterNotify 参数详细说明
参数名 | 类型 | 含义 | 规则 | 是否必填 |
workTaskNotifyType | number | 任务提醒类型 | 1-不提醒 2-任务开始时提醒 3-任务开始前5分钟提醒 4-任务开始前15分钟提醒 5-任务开始前30分钟提醒 6-任务截止前一天 注:当设置为6时,需要填写任务结束时间 | 必填 |
resourceListStr 详细说明
参数名 | 类型 | 含义 | 规则 | 是否必填 |
resourceId | String | 资源id |
| 必填 |
beginTime | String | 开始时间 | 时间戳 | 非必填 |
endTime | String | 结束时间 | 时间戳 | 非必填 |
workTaskCenterRuleList 参数详细说明
参数名 | 类型 | 含义 | 规则 | 是否必填 |
workTaskRuleType | number | 任务规则类型 | 1-签到打卡 2-填写表单 3-签退打卡 4-编辑地点信息
| 必填 |
workTaskRuleRemark | String | 任务规则描述 |
| 非必填 |
subRuleList | array | 子任务规则信息集合 |
| 当workTaskRuleType = 2/4时必填 |
| workTaskSubRuleId | String | 规则id | 当workTaskRuleType=2时,填写表单id 当workTaskRuleType=4时 -1 - 不限制 1-名称 2-地址 3-图标颜色 4-图标样式 5-文件夹 6-照片 7-描述 8-自定义字段 9-负责人 |
|