# 班前会打卡（API名称：openApiSign）
#### 功能介绍
支持外部系统接入，实现手机打卡功能
#### 相关接口
| **接口名称**                                                             | **调用说明**                                                     |
|:---|:---|
| [获取Token](https://support.huaweicloud.com/api-isdp/api_01_0019.html) | 调用该接口获取到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](https://support.huaweicloud.com/api-isdp/api_01_0019.html)中获取的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
}
```
#### 状态码
状态码请参见[状态码](https://support.huaweicloud.com/api-isdp/api_01_0326.html)。
#### 错误码
错误码请参见[错误码](https://support.huaweicloud.com/api-isdp/api_01_0327.html)。