数字作品存证接口

POST/v2/record/records

如果您是文昌链-天舟平台托管模式项目，可以使用该项目参数，通过该接口对某一类信息或文件在区块链上做存证，并且获得文昌链下发的存证证书；

请求成功之后，可以通过上链交易结果查询接口查询存证上链结果和获取证书下载链接。证书下载链接并非长期有效，请您尽快将证书文件下载至本地并妥善保管。

请求参数

identity_type

enum<integer>

可选

存证主体；1:个人；2:企业

枚举值:

identity_name

string

可选

个人姓名或企业名称，规范如下：
个人姓名：长度限制 1-16 个字符（UTF-8 编码），首字符不能是特殊符号；
企业名称：长度限制 1-50 个字符（UTF-8 编码），首字符不能是特殊符号；

未传入存证主体字段时，不支持此字段；传入存证主体字段时，此字段必填

identity_num

string

可选

个人为身份证号码，企业为统一社会信用代码；

未传入存证主体字段时，不支持此字段；传入存证主体字段时，此字段选填

>= 18 字符<= 18 字符

type

enum<integer>

必需

作品类型:
1: 其它类型；
2: 文字作品；
3: 口述作品；
4: 音乐作品；
5: 戏剧作品；
6: 曲艺作品；
7: 舞蹈作品；
8: 杂技艺术作品；
9: 美术作品；
10: 建筑作品；
11: 摄影作品；
12: 视听作品；
13: 图形作品（工程设计图、产品设计图、地图、示意图等）；
14: 模型作品；

枚举值:

1234567891011121314

name

string

作品名称

必需

>= 1 字符<= 64 字符

description

string

作品描述

必需

>= 1 字符<= 512 字符

hash

string

必需

作品哈希；将单个作品源文件使用单向散列函数（如 MD5，SHA 等）进行一次 Hash 计算；将多个作品源文件分别进行一次 Hash 计算，再将得到的 Hash 值进行二次 Hash 计算

>= 1 字符<= 128 字符

hash_type

enum<integer>

必需

作品哈希类型 1:其它； 2:SHA256；3:MD5；4:SHA256-PFV；

枚举值:

1234

operation_id

string

必需

操作 ID，保证幂等性，避免重复请求，保证对于同一操作发起的一次请求或者多次请求的结果是一致的；由接入方生成的、针对每个 Project ID 唯一的、不超过 64 个大小写字母、数字、-、下划线的字符串

>= 1 字符<= 64 字符

正则匹配:

^[a-zA-Z0-9_-]+$

{
  "identity_type": 1,
  "identity_name": "string",
  "identity_num": "stringstringstring",
  "type": 1,
  "name": "string",
  "description": "string",
  "hash": "string",
  "hash_type": 1,
  "operation_id": "string"
}

返回响应

successful operation(200)

successful operation

HTTP 状态码: 200

内容格式: JSONapplication/json

data

object

正确返回值

必需

{
  "data": {}
}

最后修改时间： 1 年前