签署合同
更新时间：2023-05-05
签署合同
接口描述
本接口用于系统自动申请CA（数字证书）并签署合同，只有合同参与者对应的address有权进行签署动作。
请求结构
JSON
1POST /saas/openapi/econtract/v1/contract/sign HTTP/1.1
2Host: xuper.baidu.com
3Content-Type: application/json;charset=utf-8
4X_BXEO_APP_ID: ak string
5X_BXEO_NONCE: nonce string
6X_BXEO_SIGN: sign string
7X_BXEO_TIMESTAMP: new time string
8X_BXEO_CONTENTMD5: body md5 string
9X_BXEO_SIGNTYPE: HMAC-SHA256
10{
11 "bxeoContent": {
12 "address": "YHePxpvYoFAK6xAdsEVGRWsvhJZvJme3w",
13 "contract_id": "BD238B2210458747",
14 "sign_position": [
15 {
16 "x1": 180,
17 "y1": 664,
18 "x2": 339,
19 "y2": 823,
20 "page": 1,
21 "signature_id": "Go4KVBOt"
22 }
23 ]
24 }
25}请求头域
- 除公共头域外，无其它特殊头域。
请求参数
| 参数名称 | 类型 | 是否必选 | 参数位置 | 描述 |
|---|---|---|---|---|
| bxeoContent | object | 是 | RequestBody参数 | body共用字段头。 |
| +address | string | 是 | RequestBody参数 | BEXO系统中用户唯一身份标识。 |
| +contract_id | string | 是 | RequestBody参数 | 合同ID，创建合同时产生。 |
| +sign_position | object | 是 | RequestBody参数 | 合同签署位置，由下方坐标组成。 |
| ++x1 | int | 是 | RequestBody参数 | 左下角为原点，横坐标像素值，签章左下角位置。 |
| ++y1 | int | 是 | RequestBody参数 | 左下角为原点，纵坐标像素值，签章左下角位置。 |
| ++x2 | int | 是 | RequestBody参数 | 左下角为原点，横坐标像素值，签章右上角位置。 |
| ++y2 | int | 是 | RequestBody参数 | 左下角为原点，纵坐标像素值，签章右上角位置。 |
| ++page | int | 是 | RequestBody参数 | 签章所在pdf页码数。 |
| ++signature_id | string | 是 | RequestBody参数 | 签章ID，由创建签章时产生。 |
响应头域
- 除公共头域外，无其它特殊头域。
响应参数
| 参数名称 | 类型 | 说明 |
|---|---|---|
| code | int | 错误码 0为成功，其他可参考常用错误码 |
| data | string | 本接口data中返回true或false |
请求示例
JSON
1POST /saas/openapi/econtract/v1/contract/sign HTTP/1.1
2Host: xuper.baidu.com
3Content-Type: application/json;charset=utf-8
4X_BXEO_APP_ID: lf2a69d4dff7dc9f3a462719da8bb942
5X_BXEO_NONCE: 12333312111
6X_BXEO_SIGN: lf2a69d4dff7dc9f3a462719da8bb942
7X_BXEO_TIMESTAMP: 1660733105
8X_BXEO_CONTENTMD5: asdaxasdsasdasdasdas
9X_BXEO_SIGNTYPE: HMAC-SHA256
10{
11 "bxeoContent": {
12 "address": "YHePxpvYoFAK6xAdsEVGRWsvhJZvJme3w",
13 "contract_id": "BD238B2210458747",
14 "sign_position": [
15 {
16 "x1": 180,
17 "y1": 664,
18 "x2": 339,
19 "y2": 823,
20 "page": 1,
21 "signature_id": "Go4KVBOt"
22 }
23 ]
24 }
25}响应示例
JSON
1HTTP/1.1 200 OK
2Content-Type: application/json;charset=UTF-8
3Date: Wed, 18 Apr 2022 03:28:11 GMT
4 {
5 "code": 0,
6 "msg": "Success",
7 "data": true
8}