创建签章
更新时间：2023-05-05
创建签章
接口描述
本接口用于生成用户在签署合同时选择的签章图片，签章要求已png格式图片，上传签章时需要区分对应用户企业或个人身份。
请求结构
POST /saas/openapi/econtract/v1/signature/create HTTP/1.1
Host: xuper.baidu.com
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
Content-Type:multipart/form-data; boundary=----WebKitFormBoundaryyb1zYhTI38xpQxBK
------WebKitFormBoundaryyb1zYhTI38xpQxBK
Content-Disposition: form-data; name="address"
xxxxxxxx
------WebKitFormBoundaryyb1zYhTI38xpQxBK
Content-Disposition: form-data; name="signature_type"
2
------WebKitFormBoundaryyb1zYhTI38xpQxBK
Content-Disposition: form-data; name="signature_img"; filename="chrome.png"
Content-Type: image/png
PNG ... content of chrome.png ...
------WebKitFormBoundaryyb1zYhTI38xpQxBK--请求头域
- 除公共头域外，无其它特殊头域。
请求参数
| 参数名称 | 类型 | 是否必选 | 参数位置 | 描述 |
|---|---|---|---|---|
| address | string | 是 | RequestBody参数 | 用户在BXEO系统中的唯一身份标识 |
| signature_img | file | 是 | RequestBody参数 | 帐号信息，由下方两个字段构成 |
| signature_type | string | 是 | RequestBody参数 | 签章类型: 1:企业签章,2:个人签章 |
响应头域
- 除公共头域外，无其它特殊头域。
响应参数
| 参数名称 | 类型 | 说明 |
|---|---|---|
| code | int | 错误码 0为成功，其他可参考常用错误码 |
| data | object | 返回的主体信息,接口返回的具体业务信息均在data下，所有接口通用 |
| +signature_id | string | 生成的签章ID，生成的唯一签章ID（后续合同签署时需用到该字段，请业务方仔细记录） |
| +img_url | string | 生成的签章URL，此URL2小时后会过期，业务方若有记录需求，请下载后记录于本地 |
请求示例
POST /saas/openapi/econtract/v1/signature/create HTTP/1.1
Host: xuper.baidu.com
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
Content-Type:multipart/form-data; boundary=----WebKitFormBoundaryyb1zYhTI38xpQxBK
------WebKitFormBoundaryyb1zYhTI38xpQxBK
Content-Disposition: form-data; name="address"
xxxxxxxx
------WebKitFormBoundaryyb1zYhTI38xpQxBK
Content-Disposition: form-data; name="signature_type"
2
------WebKitFormBoundaryyb1zYhTI38xpQxBK
Content-Disposition: form-data; name="signature_img"; filename="chrome.png"
Content-Type: image/png
PNG ... content of chrome.png ...
------WebKitFormBoundaryyb1zYhTI38xpQxBK--响应示例
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": {
"signature_id": "vCdVVgRf",
"img_url": "https://xuper-studio.bj.bcebos.com/saas_private/2022-03-29/7fd850ee9d5c17e57b19096034860da8.png?authorization=bce-auth-v1%2F79421bdabbc4447eb4cd5efd3fc2ee3f%2F2022-04-02T11%3A05%3A44Z%2F600%2F%2F63e6e36fe3c6986a5995b8cb8f9c09e60b19e45fbcbfa2ea7d24632288592e3c"
}
}