存证存入
更新时间：2023-05-05
存证存入
接口描述
本接口用于司法存证存证存入。
请求结构
POST /v2/saas/openapi/evidence/yuncrosspostevidence HTTP/1.1
Host: xuper.baidu.com
Authorization: authorization string
{
"address": address,
"court_type": court_type,
"evidence_type": evidence_type,
"content" : content
}请求头域
除公共头域外，无其它特殊头域。
请求参数
| 参数名称 | 类型 | 是否必选 | 参数位置 | 描述 |
|---|---|---|---|---|
| address | string | 是 | RequestBody参数 | 区块链帐户address |
| file_hash | string | 否(content,file_hash 不可以同时为空，至少一个存在） | RequestBody参数 | ⽂件的file_hash值，为sm3散列值，64位 |
| content | string | 否(content,file_hash 不可以同时为空，至少一个存在）） | RequestBody参数 | 最⼤1K |
| court_type | int | 是 | RequestBody参数 | 选择存证的法院，功能暂未开通，目前传0即可 |
| file_name | string | 否 | RequestBody参数 | ⽂件名称，不传证书显示"⾃定义内容" |
| user_name | string | 否 | RequestBody参数 | 作者名称（后续会⽤于证书上名称的显示） |
| upload_data | string | 否 | RequestBody参数 | 额外的字段 |
| evidence_type | int | 是 | RequestBody参数 | 2 司法存证 目前仅支持传2 |
| company_prefix | string | 否 | RequestBody参数 | 公司名称前缀，在司法证书前展示：百度-xx 分公司 |
| copyrighter_type | string | 否 | RequestBody参数 | 版权：企业，个⼈ |
| callback_url | string | 否 | RequestBody参数 | 回调地址，如果没有此参数，则会使⽤渠道默认，如果渠道也没有默认，则不回调 |
| callback_config | string | 否 | RequestBody参数 | json形式，回调配置，如果不传则使⽤默认配置。具体配置⽅式⻅下⽅说明 |
callback_config格式如下：
{
"need_callback":1,
"include":[
"eid",
"request_id",
"tx_id",
"gencert_url",
"tx_time",
"timestamp_tsa",
"user_address",
"tianping_tx"
],
"exclude":[]}回调字段说明：
- eid ⽤户传⼊唯⼀标识ID
- request_id:存证接⼝返回request_id， 16位固定⻓度字符类型
- tx_id : 本次交易⽣成的唯⼀Id
- gencert_url : 证书地址，格式为pdf
- tx_time : 存证时间
- timestamp_tsa : 可信时间戳的tsa
- user_address : 区块链上的帐户地址
- tianping_tx: 天平链返回的tx
响应头域
除公共头域外，无其它特殊头域。
响应参数
| 参数名称 | 类型 | 描述 |
|---|---|---|
| code | int | 错误码 详情查看通用说明-通用错误码 |
| msg | string | 信息描述 |
| data | array | 返回值列表 |
| + request_id | string | 返回的requestid,请妥善保存，可用于查询详情 |
| + eid | int64 | 返回的eid,请妥善保存，可用于查询详情 |
请求示例
POST /v2/saas/openapi/evidence/yuncrosspostevidence
Host: xuper.baidu.com
Authorization: bce-auth-v1/f81d3b34e48048fbb2634dc7882d7e21/2015-08-11T04:17:29Z/3600/host/74c506f68c65e26c633bfa104c863fffac5190fdec1ec24b7c03eb5d67d2e1de
{
"address": "b7KdnvQvhkJamAoqSeJRTCvVDtDvwXS5H",
"content": "hello world",
"file_hash": "fb0c373f296e62b5ee4118b76dc3820eb05477dda86703a19392ec581d12fa44",
"evidence_type": 2,
"court_type": 0,
}响应示例
HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
Date: Wed, 08 Jul 2015 03:28:11 GMT
x-bce-request-id: d8752367-38e8-45e4-b4c7-e53be3137ce5
{
"code":0,
"msg":"Success",
"data":{
"request_id":"Yms5mAjbTbVPRc6R",
"eid":221122096322002
}
}