班前会打卡(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 秘钥:A1DFA2AE3D24E5CEB5A66D82701280E0B0E40CCBCD75285925D41702F0407C02 例子: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(“919125a57076b5657c234f9d5b57220686e9998d6rfa5a10a58acb288dc92666”); 加密内容后缀:919125a57076b5657c234f9d5b57220686e9998d6rfa5a10a58acb288dc92666 |
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" : "ea7b32f62f55fd16f73738a2b3d183f877faa0f67cc548a2c0e78ec72b3e65dd", "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 }
状态码
状态码请参见状态码。
错误码
错误码请参见错误码。