文档首页/ ISDP/ API参考/ API接口/ 打卡管理/ 班前会打卡（API名称：openApiSign）
更新时间：2025-06-16 GMT+08:00
查看PDF
分享

班前会打卡（API名称：openApiSign）

功能介绍

支持外部系统接入，实现手机打卡功能

相关接口

接口名称

调用说明

获取Token

调用该接口获取到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
}

状态码

状态码请参见状态码。

错误码

错误码请参见错误码。

父主题： 打卡管理

相关文档