创建合同
更新时间:2023-05-05
创建合同
接口描述
本接口用于创建合同,创建合同需要双方或多方的address作为参与人标识。合同创建方创建个人签署合同需要完成个人实名认证,创建企业签署合同需要完成企业认证。
请求结构
JSON
1POST /saas/openapi/econtract/v1/contract/create 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":"address string"
13 "econtract_data":{
14 "econtract_name":"econtract_name string",
15 "deadline_time":"deadline_time int ",
16 "signatory_data":{
17 "creator_signatory_info":{
18 "sign_position":"sign_position object",
19 "sign_account_type":"sign_account_type int"
20 }
21 "partner_signatory_info":{
22 "sign_address":"sign_address string",
23 "sign_position":"sign_position object",
24 "sign_account_type":"sign_account_type int"
25 "sign_name":"sign_name string"
26 }
27 }
28 }
29
30 }
31}
请求头域
- 除公共头域外,无其它特殊头域。
请求参数
参数名称 | 类型 | 是否必选 | 参数位置 | 描述 |
---|---|---|---|---|
bxeoContent | object | 是 | RequestBody参数 | body共用字段头 |
+address | string | 是 | RequestBody参数 | BEXO系统中用户唯一身份标识 |
+econtract_data | object | 是 | RequestBody参数 | 合同信息,支持批量一次性创建多份合同。字段由下方组成 |
++econtract_name | string | 是 | RequestBody参数 | 合同名称 |
++deadline_time | string | 是 | RequestBody参数 | 签署截止时间,格式为UNIX时间戳,即:从1970年1月1日(UTC/GMT的午夜)开始所经过的秒数,不考虑闰秒 |
++file_id | string | 是 | RequestBody参数 | 创建合同所用文档ID,由《文档类》中的《上传合同文档》接口获取 |
++signatory_data | object | 是 | RequestBody参数 | 签署信息,由下方字段组成 |
+++creator_signatory_info | object | 是 | RequestBody参数 | 创建者相关信息,由下方字段组成 |
++++sign_position | string | 是 | RequestBody参数 | 指定签署位置,可指定多个位置,具体内容见下方说明 |
++++sign_account_type | int | 是 | RequestBody参数 | 签署身份类型,1企业 2个人 |
+++partner_signatory_info | object | 是 | RequestBody参数 | 创建者相关信息,由下方字段组成 |
++++sign_address | string | 是 | RequestBody参数 | 签署人ID,BXEO唯一身份标识 |
++++sign_position | string | 是 | RequestBody参数 | 指定签署位置,可指定多个位置,具体内容见下方说明 |
++++sign_account_type | int | 是 | RequestBody参数 | 签署身份类型,1企业 2个人 |
++++sign_name | string | 是 | RequestBody参数 | 签署人名称,如用户已经完成实名或企业认证将进行强校验 |
sign_position参数说明:
参数名称 | 类型 | 是否必选 | 参数位置 | 描述 |
---|---|---|---|---|
basePX | int | 否 | RequestBody参数 | 显示器基础像素,传参仅作为辅助前端开发时定位使用。 |
basePT | int | 否 | RequestBody参数 | 显示器基础磅,传参仅作为辅助前端开发时定位使用。 |
pageHeight | int | 否 | RequestBody参数 | 当前页面高度,传参仅作为辅助前端开发时定位使用。 |
pageWidth | int | 否 | RequestBody参数 | 当前页面宽度,传参仅作为辅助前端开发时定位使用。 |
height | int | 否 | RequestBody参数 | 签章高度,传参仅作为辅助前端开发时定位使用。 |
width | int | 否 | RequestBody参数 | 签章宽度,传参仅作为辅助前端开发时定位使用。 |
x | int | 否 | RequestBody参数 | 左下角为原点,横坐标像素值,,传参仅作为辅助前端开发时定位使用。 |
y | int | 否 | RequestBody参数 | 左下角为原点,横坐标像素值,传参仅作为辅助前端开发时定位使用。 |
x1 | int | 是 | RequestBody参数 | 左下角为原点,横坐标像素值,签章左下角位置 |
y1 | int | 是 | RequestBody参数 | 左下角为原点,纵坐标像素值,签章左下角位置 |
x2 | int | 是 | RequestBody参数 | 左下角为原点,横坐标像素值,签章右上角位置 |
y2 | int | 是 | RequestBody参数 | 左下角为原点,纵坐标像素值,签章右上角位置 |
page | int | 是 | RequestBody参数 | pdf需盖章页码数 |
响应头域
- 除公共头域外,无其它特殊头域。
响应参数
参数名称 | 类型 | 说明 |
---|---|---|
code | int | 错误码 0为成功,其他可参考常用错误码 |
data | string | 本接口data中返回的信息为企业社会统一信用代码(和用户传入的一致) |
请求示例
JSON
1POST /saas/openapi/econtract/v1/contract/create 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": "XZEXXPLb7W63gyyDNuwCgmphug6zQ9Yk6",
13 "econtract_data": [
14 {
15 "econtract_name": "zzz",
16 "deadline_time": 1759818729,
17 "file_id": "F3YFpVOodpNTFDDu",
18 "signatory_data": {
19 "creator_signatory_info": {
20 "sign_position": [
21 {
22 "basePX": 1333,
23 "y2": 877,
24 "pageHeight": 1122,
25 "pageWidth": 793,
26 "y1": 718,
27 "basePT": 1000,
28 "height": 159,
29 "x2": 672,
30 "width": 159,
31 "y": 245,
32 "x": 513,
33 "x1": 513,
34 "page": 1
35 }
36 ],
37 "sign_account_type": 2,
38 "sign_order": 0
39 },
40 "partner_signatory_info": [
41 {
42 "sign_address": "bnr1rBdPSQoAP4nQkxYztsnLcK9PxfZgp",
43 "sign_order": 0,
44 "sign_position": [
45 {
46 "basePX": 1333,
47 "y2": 904,
48 "pageHeight": 1122,
49 "pageWidth": 793,
50 "y1": 745,
51 "basePT": 1000,
52 "height": 159,
53 "x2": 699,
54 "width": 159,
55 "y": 218,
56 "x": 540,
57 "x1": 540,
58 "page": 1
59 }
60 ],
61 "sign_account_type": 1,
62 "sign_name": "北京百度网讯科技公司"
63 }
64 ]
65 }
66 }
67 ]
68 }
69}
响应示例
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": [
8 "BD84802220446737"
9 ]
10}