深圳市住建局智慧建造安全生产记录仪接入说明

1. 背景

为贯彻落实国家、省、市关于房屋市政工程安全生产治本攻坚三年行动部署要求，根据市住房建设局《关于全市房屋市政工程专职安全生产管理人员配备使用安全生产检查记录仪的通知》要求，加快推进安全生产记录仪接入工作，特制定本接入说明，供各单位参照使用。

         文档为服务商接入时需要的接口文档，接口相关说明也可参考以下链接：https://doc.apipost.net/docs/detail/32d88f4f4464000?target_id=2d6b261bb47000。

2. 接入步骤

2.1. 环境准备

正式环境：https://ypt.szsti.org/szmis-web

2.2. 鉴权

2.2.1. token申请

发邮件到zhihuijianzao@szsti.org

申请说明下载地址：

http://qg.ypt.szsti.org/file/住建项目监测设备对接token申请.docx

2.2.2. 签名生成

详见接口文档

3. 错误码

详见接口文档

4. 常见问题

详见接口文档

5. 接口文档

目录Header参数

目录Query参数

目录Body参数

目录认证信息

继承父级

5.1. 上报项目信息

上报项目相关信息每个项目只需要上报一次

接口状态

开发中

接口URL

/api/v2/project/create

请求方式

POST

Content-Type

json

请求Header参数

请求Body参数

{
    "thirdProjectId": "123",
    "projectName": "项目名称",
    "provider": "厂商",
    "createUser": "123123123123123",
    "status": "正常"
}

认证方式

继承父级

响应示例

• 成功(200)

{
    "result": "null",
    "messages": [
        "0"
    ],
    "status": "4002"
}

• 失败(404)

暂无数据

5.2. 上报设备信息

暂无描述

接口状态

开发中

接口URL

/api/v1/device/create

请求方式

POST

Content-Type

json

请求Body参数

{
    "projectId": "平台项目id",
    "cameraId": "123",
    "cameraType": "具体型号",
    "provider": "厂商",
    "user": "人员",
    "phone":"手机号",
    "job": "职位(安全员，安全总监...)"
}

认证方式

继承父级

响应示例

• 成功(200)

{
    "result": "null",
    "messages": [
        "0"
    ],
    "status": "4002"
}

• 失败(404)

{
    "result": "null",
    "messages": [
        "0"
    ],
    "status": "4002"
}

5.3. 上报使用情况

暂无描述

接口状态

开发中

接口URL

/api/v1/record/create

请求方式

POST

Content-Type

json

请求Body参数

{
    
    "deviceId": "平台设备id",
    "projectId": "平台项目id",
    "rowId":"第三方使用记录id",
    "onlineTime": 7200,
    "openTime": "2024-09-12 12:00:00",
    "closeTime": "2024-09-12 14:00:00",
    "user": "人员",
    "phone": "手机号",
    "job": "职位(安全员，安全总监...)"
}

认证方式

继承父级

响应示例

• 成功(200)

{
    "result": "null",
    "messages": [
        "0"
    ],
    "status": "4002"
}

• 失败(404)

暂无数据

5.4. 上报轨迹信息

标签

按设备为维度上报轨迹信息

服务商有自己的个性字段需要上报的，可以填入extend中，接收json格式。

接口状态

开发中

接口URL

/api/v1/trajectory/create

请求方式

POST

Content-Type

json

请求Body参数

{
    "deviceId": "平台设备id",
    "projectId": "平台项目id",
    "recordRowId": "第三方使用记录id",
    "collectTime": "2024-09-05 15:52:35",
    "gps": [
        {
            "height": "555",
            "latitude": "22.674555555555557",
            "longitude": "113.89651111111111"
        }
    ],
    "direction": "描述",
    "user": "张三",
    "phone": "13510648888",
    "extend": "扩展字段json格式",
    "buildId": "建筑id",
    "floorId": "楼层id",
    "buildName": "建筑名称",
    "floorName": "建筑名称",
    "videoUrl": "视频链接",
    "patrolUrl": "全景链接",
    "cadTrackUrl": "轨迹图链接"
}

认证方式

继承父级

响应示例

• 成功(200)

{
    "result": "null",
    "messages": [
        "0"
    ],
    "status": "4002"
}

• 失败(404)

{
    "result": "null",
    "messages": [
        "0"
    ],
    "status": "4002"
}