项目施工记录-附件明细数据
接口说明
该接口用于获取项目施工记录-附件明细数据
接口地址
/v2/project-record-attachment?startId=0&startVersion=0&limit=200&orgId=442579570831360
接口类型
Http
请求方式
GET
内容类型
application/json
鉴权策略
参见《Open-API鉴权协议》
请求参数
| 参数名称 | 说明 |
|---|---|
| startId | 本次请求所要获取的增量数据的id起始值,第一次调用初始值为0,客户端需要缓存接口返回的数据集合中最后一条数据的id值 |
| startVersion | 本次请求所要获取的增量数据的version起始值,第一次调用初始值为0,客户端需要缓存接口返回的数据集合中最后一条数据的version值 |
| limit | 返回指定的数据条数,上限为500条,0 <= limit <= 500。如果limit > 500, 则最多返回500条数据 |
| orgId | 组织机构Id, 不传查询所有组织数据 |
请求头
响应报文
[
{
"id": 470990782795776,
"longitude": null,
"latitude": null,
"address": null,
"removed": false,
"version": 470990782533632,
"orgId": 442579570831360,
"projectRecordId": 463928966270976,
"resourceKey": "record-attachments/c663d47a-4757-4f67-a82e-eba177645acd.jpg",
"resourceType": "image",
"createdAt": "2019-04-08T09:13:27.000Z"
}
]
响应状态码
| 字段名称 | 数据类型 |
|---|---|
| 200 | 成功 |
| 400 | 用户请求头中Authorization值的格式不对,错误码:InvalidArgument。 |
| 403 | AccessId不存在或被禁用 错误码:InvalidAccessId |
| 500 | 非法参数或接口执行异常 |
响应数据结构
| 字段名称 | 数据类型 | 是否可以为空 | 字段描述 |
|---|---|---|---|
| id | bigint | 否 | 附件Id |
| longitude | double | 是 | 经度 |
| latitude | double | 是 | 纬度 |
| address | string | 是 | 地址 |
| removed | boolean | 否 | 是否逻辑删除 见表1 |
| version | bigint | 否 | 数据版本 |
| orgId | bigint | 否 | 组织机构Id |
| projectRecordId | bigint | 否 | 施工记录Id |
| resourceKey | string | 否 | 附件资源地址 |
| resourceType | string | 是 | 附件资源类型 |
| createdAt | timestamp | 否 | 上传时间,utc标准时间格式 |
表1 逻辑删除标志位枚举值定义
| removed | |
|---|---|
| false | 未删除 |
| true | 已删除 |