正式环境域名

https://open.mokan.cn

访问签名（java）

//毫秒
long timestamp = System.currentTimeMillis();
//租户key请向客服人员索取
String key=xxx;
//租户 code请向客服人员索取
String code=yyy;
//将字符串拼接起来：xxxyyy123455668456
String keywords = key + code + timestamp;
//md5并转为大写
String sign = SecureUtil.md5(keywords).toUpperCase();

HttpRequest request = HttpUtil.createGet(url);
request.header("timestamp", String.valueOf(timestamp));
request.header("clientCode", code);
request.header("sign", sign);

访问签名（php）

// 时间戳（毫秒）
        $timestamp = time() * 1000 + (3600 * 1000 * 2);
        // 租户key，请向客服人员索取。
        $key = 'xxxxxxxxxxxxx';
        // 租户code，请向客服人员索取。
        $code = 'xxxxxxxxxxxxx';
        // 请求头
        $header = [
            'timestamp:' . $timestamp,
            'clientCode:' . $code,
            'sign:' . (strtoupper(md5(sprintf('%s%s%s', $key,$code, $timestamp)))),
            'Content-Type:application/json',
        ];

推荐对接路径

必要对接：

1.同步工地（带设备，请注意保存projectId）：https://doc.mokan.cn/docs/open-api/open-api-1d3ol4t51dta0 (自动从上个工地解绑，自动领用绑定设备，自动创建主次要负责人)
2.工地直播：https://doc.mokan.cn/docs/open-api/open-api-1dde1j03b7r95 （可嵌入小程序/app）

按需对接：

3.工人同步（请注意保存userId）：https://doc.mokan.cn/docs/open-api/open-api-1d3olavo29ohs （同步完成后可联系客服获取工人统一上传人脸链接，上传人脸后即可在工地打卡）
4.员工同步（按需对接）：https://doc.mokan.cn/docs/open-api/open-api-1d3okq0j7l3uc
4.接口人脸上传：https://doc.mokan.cn/docs/open-api/open-api-1d3okq0j7l3uc#hks72
5.施工报告：https://doc.mokan.cn/docs/open-api/open-api-1d3ol9ups4jj8#djgyum
6.考勤实时推送：https://doc.mokan.cn/docs/open-api/open-api-1dnnqb9j2cbqj
7.考勤记录：https://doc.mokan.cn/docs/open-api/open-api-1d3ol94d5d9cg
8.绑定设备（工地创建后需要添加设备使用此接口）：https://doc.mokan.cn/docs/open-api/open-api-1d3ol4t51dta0#cfl3es

新增工地

• 项目监理eopId

  http://hostname:port/openapi/project/querySupervisorListWithCompany?keyword=梁

• 项目经理eopId

  http://hostname:port/openapi/project/queryManagerListWithCompany?keyword=李

• 真实开工时间realStartDate不能晚于当前时间

• 查询当前租户项目监理列表(获取userId)

  http://hostname:port/openapi/project/querySupervisorListWithCompany?keyword=李

  获取userId

• 查询项目监理未绑定设备(获取deviceId)

  参数supervisorUserId来自于查询项目监理列表

  http://hostname:port/openapi/project/queryCanBindDeviceBySupervisorId?supervisorUserId=1395320666498310145

• 新增工地

  项目监理supervisorEopId来自于前面接口获取;

  项目经理managerEopId来自于前面接口获取;

  设备iddeviceId来自于前面接口获取;

  {
      "project": {
          "name": "鼓浪屿",
          "planStartDate": "2021-06-29",
          "weekendWork": "true",
          "planDays": 7,
          "supervisorEopId": "1407163776009207809",
          "managerEopId": "1397099320362188802",
          "realStartDate": "2021-06-29"
      },
      "projectDevices": [
          {
              "deviceId": "23",
              "area": "西北"
          }
      ]
  }

领用设备业务

• 查询设备分页列表(获取deviceId)

  http://hostname:port/openapi/ai/devicePage

  获取:installStatus是UNINSTALL;receiveStatus是false的数据.

  最终获取未安装并且未领用的设备deviceId

• 查询当前租户项目监理列表(获取userId)

  http://hostname:port/openapi/project/querySupervisorListWithCompany?keyword=李

  获取userId

• 项目监理领用设备

  http://hostname:port/openapi/ai/deviceReceive

  deviceId和receiveUser参数来自于前面步骤

• 查看当前工地可以绑定设备(领用后才能看到)

  http://hostname:port/openapi/project/queryCanBindDeviceByProjectId/1409452905006440450

• 工地绑定设备

  注意事项: 工地完工以后不能绑定设备

  http://hostname:port/openapi/project/bindDevice

• 查看当前工地已绑定设备

  http://hostname:port/openapi/project/beenBindDeviceList?projectId=1409452905006440450

• 设备分页列接口也可以看到当前deviceId的设备处于已领用和已安装状态

退回设备业务

• 注意事项

  必须先解绑,然后项目监理再退回设备!

  否则报错信息为:”业务异常:设备绑定工地中，不允许退回！”

• 工地解绑设备

  http://hostname:port/openapi/project/unbindDevice?deviceId=23&projectId=1409452905006440450

• 项目监理退回设备

  http://hostname:port/openapi/ai/deviceBack?deviceId=23

• 设备分页列接口也可以看到当前deviceId的设备处于未领用和未安装状态

工地完工

• 自动把当前工地的设备解除绑定

工地成员

• 工人列表接口只包含工人

• 项目成员列表包含项目监理|设计师|业主|工人

  http://hostname:port/openapi/projectMember/queryList?projectId=1409452905006440450

• 新增设计师

  • 想获取设计师相关参数

    参数来自于查询http://hostname:port/openapi/project/queryDesignerListWithCompany?keyword=李接口返回的userId和eopId

  • 新增设计师

  {
      "projectId":"1409452905006440450",
      "userId":"1333697709738221570",
      "eopId":"1347072094438617089"
  }