班前会打卡（API名称：openApiSign）
功能介绍
支持外部系统接入，实现手机打卡功能
相关接口
| 接口名称 | 调用说明 |
|---|---|
| 调用该接口获取到Token，再调用其他接口时，需要在请求消息头中添加“Authorization”，其值即为Token。 |
URL
| 请求方式 | HTTPS地址 | 服务架构 | 消息体类型 |
|---|---|---|---|
| POST | https://isdp+域名/openapi/v1/openApiSign/openApiSign | OpenAPI | application/json |
请求头
| KEY | VALUE | 是否必填 | 描述 |
|---|---|---|---|
| Content-Type | application/json | 是 | 无 |
| Authorization | bearer ${access_token} | 是 | bearer +“ ”+5.2.1中获取的access_token的值 |
请求参数
| 参数 | 类型 | 是否必填 | 描述 |
|---|---|---|---|
| comparisonValue（加密体） | String | 是 | 加密字段有（按顺序）：longitude ,latitude，，originLongitude ,originLatitude，signLocation 秘钥：A1DFA2AE3**************************0CCBCD75285925D41702F0407C02 例子：StringBuilder plainText = new StringBuilder(); plainText.append("114.056332").append("&&"); plainText.append("22.667371").append("&&"); plainText.append("22.667571").append("&&"); plainText.append("55.663371").append("&&"); plainText.append("测试大道").append("&&"); plainText.append(“919125a57076b5657c234f9d5b57220686e***********************2666”); 加密内容后缀：919125a57076b5657c234f9d5b57220686e***********************2666 |
| latitude | String | 是 | 纬度 |
| longitude | String | 是 | 经度 |
| originLatitude | String | 是 | 原点纬度 |
| originLongitude | String | 是 | 原点经度 |
| signLocation | String | 是 | 打卡地址 |
| projectNo | String | 否 | 项目编码 |
| signPhotoModelList | String | 否 | 图片 |
| signTimestamp | String | 是 | 打卡时间戳 |
| submitTime | String | 是 | 提交时间戳 |
响应参数
| 参数 | 类型 | 描述 |
|---|---|---|
| result | Object | 响应消息体 |
| errorMessage | String | 错误信息，接口错误时有值，正常调用时为空 |
| stateCode | String | 响应状态，“0”为成功，其他值失败 |
请求示例
{
"comparisonValue" : "ea7b32f62*********************************ec72b3e65dd",
"longitude" : "114.056332",
"latitude" : "22.667371",
"originLongitude":"22.667571",
"originLatitude":"55.663371",
"signLocation":"测试大道",
"projectNo":"",
"submitTime" : "1668067378160",
"signPhotoModelList" : [],
"signTimestamp" : 1668067378167
} 响应示例
{
"stateCode": "0",
"errorMessage": null,
"result": null
} 状态码
状态码请参见状态码。
错误码
错误码请参见错误码。
