班前会打卡（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
}
状态码
状态码请参见状态码。
错误码
错误码请参见错误码。
