山东省农民工工资支付监管平台

山东省农民工工资支付监管平台考勤数据集成接口山东省农民工工资支付监管平台二○二○年三月目录1api接口 说明 关于失联党员情况说明岗位说明总经理岗位说明书会计岗位说明书行政主管岗位说明书 ..................................................................................................................................31.1操作步骤说明......................................................................................................................31.2整体 流程 快递问题件怎么处理流程河南自建厂房流程下载关于规范招聘需求审批流程制作流程表下载邮件下载流程设计 图..........................................................................................................................32接口调用..........................................................................................................................................52.1设备心跳..............................................................................................................................52.1.1请求地址..................................................................................................................52.1.2请求参数说明..........................................................................................................52.1.3响应参数说明..........................................................................................................62.2设备获取任务......................................................................................................................62.2.1请求地址..................................................................................................................62.2.2请求参数说明..........................................................................................................62.2.3响应参数说明..........................................................................................................72.2.4公共响应参数..........................................................................................................72.2.5添加人员任务data数据返回格式.......................................................................72.2.6添加人脸任务data数据返回格式.......................................................................82.2.7修改人脸任务data数据返回格式.......................................................................82.2.8删除人员任务data数据返回格式.......................................................................82.3设备任务执行异步结果通知..............................................................................................92.3.1请求地址..................................................................................................................92.3.2请求参数说明..........................................................................................................92.3.3响应参数说明........................................................................................................102.4考勤信息上传....................................................................................................................102.3.1请求地址................................................................................................................102.3.2请求参数说明........................................................................................................102.3.3响应参数说明........................................................................................................113附录................................................................................................................................................123.1code码对照表..................................................................................................................123.2联系人...............................................................................................................................121api接口说明服务端接口采用 标准 excel标准偏差excel标准偏差函数exl标准差函数国标检验抽样标准表免费下载红头文件格式标准下载 http协议通讯，数据以json格式放在body中传输。设备厂商在开发时，需要向服务端申请，由服务端发放appId与appSecretKey以及用于对参数MD5加密的md5Key，设备厂商需要按照文档中，对规定参数拼接加密组装成md5Value的值。设备厂商的设备在上线到工地后，设备ip地址是与工地互相绑定的，请设备厂商在开发时采用设备和服务端直连的方式，不要进行服务器中转和服务端对接，以免ip绑定限制。1.1操作步骤说明步骤一设备通过设备心跳接口每隔60秒询问服务端。服务端向设备返回trueorfalse的值。true:代表服务端有任务需要设备执行，业务流转到设备获取任务的URL接口；false：判断为无任务，即无需处理。步骤二在设备心跳接口接收到true值后，调用设备获取任务的URL接口，传入需要调用接口的参数，进行接口调用，服务端如果有任务会返回true值和任务，服务端每次只返回一条任务，而且返回的任务是有序的，需要设备按照先进先出的原则，把任务放在队列中顺序执行。步骤三设备每处理完一条任务后，不管执行结果是成功或失败，都需要调用设备任务执行异步结果通知接口返回处理结果。服务端返回true:服务端还有需要处理的任务，设备可以调用获取任务的URL接口继续进行任务获取。false：服务端已经没有要执行的任务了，无需处理，流程结束，等待心跳开启下次任务执行。1.2整体流程图特别说明：设备端需要单线程按顺序对任务进行处理，防止任务执行顺序颠倒，导致任务失败。2接口调用2.1设备心跳2.1.1请求地址环境请求地址测试环境posthttp://60.213.233.34:7001/platform/api/deviceHeartBeat正式环境posthttp://117.73.252.198:7001/platform/api/deviceHeartBeat2.1.2请求参数说明参数名称类型是否必填最大长度描述备注appIdString是32服务端分配的开发者应用公共请求参数IDappSecretKeyString是64服务端分配的开发者应用私公共请求参数钥timestampLong是20设备请求时间戳，精确到毫公共请求参数秒charsetString是20请求使用的编码格式，公共请求参数如utf-8md5ValueString是-通过md5Key混合要加密的公共请求参数参数进行md5加密得到。md5key+appId+timestamp+deviceKeysversionString否10调用的接口版本，固定公共请求参数为：1.0.0deviceKeyString是64设备唯一标识码datajson是-timeLong是20设备当前时间戳,精确到秒data中的子项versionString是20设备版本号data中的子项2.1.3响应参数说明参数名称类型是否必填最大长度描述备注statusString是-成功标志FAILURE/SUCCESScodeString是-接口返回码，详见接口code码对照表msgString是-消息taskFlagboolean是-服务端任务标识，如果为true说明有任务，需要设备调用任务获取接口获取任务2.2设备获取任务2.2.1请求地址环境请求地址测试环境posthttp://60.213.233.34:7001/platform/api/getTask正式环境posthttp://117.73.252.198:7001/platform/api/getTask2.2.2请求参数说明参数名称类型是否必填最大长度描述备注appIdString是32服务端分配的开发者应用ID公共请求参数appSecretKeyString是64服务端分配的开发者应用私公共请钥求参数timestampLong是20设备请求时间戳，精确到毫秒公共请求参数charsetString是20请求使用的编码格式，公共请如utf-8求参数md5ValueString是-通过md5Key混合要加密的参公共请数进行md5加密得到。求参数md5key+appId+timestamp+deviceKeysversionString否10调用的接口版本，固定公共请为：1.0.0求参数deviceKeyString是64设备唯一标识码2.2.3响应参数说明2.2.4公共响应参数参数名称类型是否必填最大长度描述备注statusString是-成功标志FAILURE/SUCCESScodeString是-接口返回码，详见接口code码对照表msgString是-消息taskFlagboolean是-服务端任务标识，如果为true说明获取到了可以执行的任务dataJson否-当taskFlag为false时data为null2.2.5添加人员任务data数据返回格式参数名称类型是否必最大长度描述备注填taskNoString是-任务唯一编号interfaceNameString是-接口名称person/createidString是-人员idnameString是-人员姓名2.2.6添加人脸任务data数据返回格式参数名称类型是否必最大长描述备注填度taskNoString是-任务唯一编号interfaceNameString是-接口名称face/createByBase64idString是-人员id和添加人员的id对应imgString(base64)是-人脸照片2.2.7修改人脸任务data数据返回格式参数名称类型是否必最大长描述备注填度taskNoString是-任务唯一编号interfaceNameString是-接口名称face/updateidString是人员id和添加人员的id对应imgString(base64)是人脸照片2.2.8删除人员任务data数据返回格式特别说明：设备需要同时删除人员和人脸信息参数名称类型是否必最大长度描述备注填taskNoString是-任务唯一编号interfaceNameString是-接口名称person/deleteidString是人员id对应nameString是姓名2.3设备任务执行异步结果通知特别说明：服务端不支持同步任务结果通知，请知悉2.3.1请求地址环境请求地址测试环境posthttp://60.213.233.34:7001/platform/api/taskCallback正式环境posthttp://117.73.252.198:7001/platform/api/taskCallback2.3.2请求参数说明参数名称类型是否必填最大长度描述备注appIdString是32服务端分配的开发者应用ID公共请求参数appSecretKeyString是64服务端分配的开发者应用私钥公共请求参数timestampLong是20设备请求时间戳，精确到毫秒公共请求参数charsetString是20请求使用的编码格式，公共请如utf-8求参数md5ValueString是-通过md5Key混合要加密的参公共请数进行md5加密得到。求参数md5key+appId+timestamp+taskNosversionString否10调用的接口版本，固定公共请为：1.0.0求参数deviceKeyString是64设备唯一标识码datajson是-taskNoString是64任务唯一编号data中的子项successboolean是-任务成功失败标识data中的子项msgString是200设备端自定义，描述具体成功data中或失败原因的子项numString是20设备端自定义，成功或失败原data中因编码的子项2.3.3响应参数说明特别说明：如果该次请求没有响应，请建立任务尝试间隔并多次通知，直到通知成功为止。参数名称类型是否必填最大长度描述备注statusString是-成功标志FAILURE/SUCCESScodeString是-接口返回码，详见接口code码对照表msgString是-消息taskFlagboolean是-服务端任务标识，如果为true说明服务端还有可执行任务，可以立即调用获取任务接口2.4考勤信息上传2.3.1请求地址环境请求地址测试环境posthttp://60.213.233.34:7001/platform/api/identifyCallBack正式环境posthttp://117.73.252.198:7001/platform/api/identifyCallBack2.3.2请求参数说明参数名称类型是否必填最大长度描述备注appIdString是32服务端分配的开发者应用ID公共请求参数appSecretKeyString是64服务端分配的开发者应用私公共请求钥参数timestampLong是20设备请求时间戳，精确到毫秒公共请求参数charsetString是20请求使用的编码格式，公共请求如utf-8参数md5ValueString是-通过md5Key混合要加密的参公共请求数进行md5加密得到。参数md5key+appId+timestamp+personIdsversionString否10调用的接口版本，固定公共请求为：1.0.0参数deviceKeyString是64设备唯一标识码datajson是-idString是64人员iddata中的子项timeLong是20考勤时间戳，精确到秒data中的子项base64imageString是20设备考勤图片data中的子项2.3.3响应参数说明特别说明：如果没有响应，请建立任务尝试间隔并多次通知，通知成功为止，否者会没有该次考勤，服务端返回true即为通知成功参数名称类型是否必填最大长度描述备注statusString是-成功标志FAILURE/SUCCESScodeString是-接口返回码，详见接口code码对照表msgString是-消息3附录3.1code码对照表code编码后期维护会有调整，请以系统中实际返回为准。编码含义10000成功9999失败100系统中未找到该设备101参数值验证失败102MD5Value加密值不合法103开发者秘钥不合法104ip不合法3.2联系人名称联系方式备注戴立凯kaixuan180356（微信）技术对接客服电话4006797588