创建合同
接口描述
本接口用于创建合同，创建合同需要双方或多方的address作为参与人标识。合同创建方创建个人签署合同需要完成个人实名认证，创建企业签署合同需要完成企业认证。
请求结构
POST /saas/openapi/econtract/v1/contract/create HTTP/1.1
Host: xuper.baidu.com
Content-Type: application/json;charset=utf-8
X_BXEO_APP_ID: ak string
X_BXEO_NONCE: nonce string
X_BXEO_SIGN: sign string
X_BXEO_TIMESTAMP: new time string
X_BXEO_CONTENTMD5: body md5 string
X_BXEO_SIGNTYPE: HMAC-SHA256
{
"bxeoContent":{
"address":"address string"
"econtract_data":{
"econtract_name":"econtract_name string",
"deadline_time":"deadline_time int ",
"signatory_data":{
"creator_signatory_info":{
"sign_position":"sign_position object",
"sign_account_type":"sign_account_type int"
}
"partner_signatory_info":{
"sign_address":"sign_address string",
"sign_position":"sign_position object",
"sign_account_type":"sign_account_type int"
"sign_name":"sign_name string"
}
}
}
}
}
请求头域
请求参数
| 参数名称 |
类型 |
是否必选 |
参数位置 |
描述 |
| 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中返回的信息为企业社会统一信用代码（和用户传入的一致） |
请求示例
POST /saas/openapi/econtract/v1/contract/create HTTP/1.1
Host: xuper.baidu.com
Content-Type: application/json;charset=utf-8
X_BXEO_APP_ID: lf2a69d4dff7dc9f3a462719da8bb942
X_BXEO_NONCE: 12333312111
X_BXEO_SIGN: lf2a69d4dff7dc9f3a462719da8bb942
X_BXEO_TIMESTAMP: 1660733105
X_BXEO_CONTENTMD5: asdaxasdsasdasdasdas
X_BXEO_SIGNTYPE: HMAC-SHA256
{
"bxeoContent": {
"address": "XZEXXPLb7W63gyyDNuwCgmphug6zQ9Yk6",
"econtract_data": [
{
"econtract_name": "zzz",
"deadline_time": 1759818729,
"file_id": "F3YFpVOodpNTFDDu",
"signatory_data": {
"creator_signatory_info": {
"sign_position": [
{
"basePX": 1333,
"y2": 877,
"pageHeight": 1122,
"pageWidth": 793,
"y1": 718,
"basePT": 1000,
"height": 159,
"x2": 672,
"width": 159,
"y": 245,
"x": 513,
"x1": 513,
"page": 1
}
],
"sign_account_type": 2,
"sign_order": 0
},
"partner_signatory_info": [
{
"sign_address": "bnr1rBdPSQoAP4nQkxYztsnLcK9PxfZgp",
"sign_order": 0,
"sign_position": [
{
"basePX": 1333,
"y2": 904,
"pageHeight": 1122,
"pageWidth": 793,
"y1": 745,
"basePT": 1000,
"height": 159,
"x2": 699,
"width": 159,
"y": 218,
"x": 540,
"x1": 540,
"page": 1
}
],
"sign_account_type": 1,
"sign_name": "北京百度网讯科技公司"
}
]
}
}
]
}
}
响应示例
HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
Date: Wed, 18 Apr 2022 03:28:11 GMT
{
"code": 0,
"msg": "Success",
"data": [
"BD84802220446737"
]
}
