API Reference
中国知链 API 文档展示
根据公开 API 文档整理，覆盖文件上传、订单数据上链、著作权人、版权存证、证书与链上记录查询等接口。正式联调请以原始文档、平台分配的 appid/secret 和测试环境返回为准。
接入概览
基础地址：https://chain.haisejue.cn。公开文档展示的接口均为 POST 请求，示例文档使用 multipart/form-data 表单提交。生产使用前应先完成应用开通、密钥分配、接口权限确认和测试联调。
BASE
查看原始 API 文档https://chain.haisejue.cn公共请求参数
以下参数为文档展示的公共鉴权字段，通常随每次接口请求一并提交。
appid必填平台分配的应用 ID，用于识别调用方。
timestamp必填10 位 Unix 时间戳，用于控制请求时效。
nonce必填16 位随机字符串，用于降低重复请求风险。
sign必填签名值，根据请求参数和 secret 计算。
签名规则
过滤空值参数，按参数名进行字典序排序，统一类型转换后拼接为 key=value 字符串，再追加平台分配的 secret，计算 32 位小写 MD5。文件字段通常不参与普通字符串拼接，具体以联调要求为准。
params = filterEmpty(params)
query = sortByKey(params).map(k => k + "=" + params[k]).join("&")
sign = md5(query + secret).toLowerCase()安全建议：secret 不应写入前端页面或移动端明文包中，应由客户服务端生成签名并发起接口请求。
通用返回结构
公开文档示例主要体现状态码、消息和数据对象。不同接口的 data 字段结构以实际返回为准。
{
"code": 200,
"msg": "success",
"data": {}
}code返回码用于判断请求处理结果。
msg提示信息返回成功或错误原因描述。
data业务数据接口返回的文件、订单、证书、链上记录等信息。
文件上传与查询
用于将文件材料上传至平台并查询文件存证或上传结果，适合合同、证明材料、报告、图片、证书底稿等文件类场景。
POST
/api/file/uploadfile业务字段待上传文件。公开页面未展开完整字段约束，大小、格式、是否必填以联调文档为准。
appid/timestamp/nonce/sign公共字段每次请求均需提交。
POST
/api/file/queryfile_id参考字段可按平台返回的文件标识查询，实际字段名以测试环境返回为准。
hash参考字段可按文件摘要查询，实际是否支持以联调为准。
订单数据上链与查询
用于电商、消费、会员、积分、售后等业务数据形成上链存证记录。通常应提交订单号、业务摘要、主体信息和必要的场景字段。
POST
/api/order_hash/createorder_no参考字段业务订单号或客户侧唯一编号。
hash参考字段业务数据摘要，用于表示被存证内容。
meta参考字段订单金额、商品、用户、时间等扩展信息，具体字段按项目确定。
POST
/api/order_hash/queryorder_no参考字段按订单号查询链上记录。
chain_id参考字段按平台返回的链上记录编号查询。
著作权人新增与查询
用于版权、内容、证书签发等场景中维护权利人或主体信息。公开文档展示了新增和查询两个接口。
POST
/api/chain_user/createname参考字段著作权人、企业或主体名称。
id_no / credit_code参考字段个人或企业身份标识字段，是否提交需按业务合规要求确定。
contact参考字段联系人或联系方式，正式项目中应遵守个人信息保护要求。
POST
/api/chain_user/query版权存证与查询
用于版权作品、内容素材、报告文件和证书类数据的存证创建与查询。可与文件上传、著作权人信息和证书展示页面组合使用。
POST
/api/cert/createtitle参考字段作品、证书或存证事项标题。
user_id参考字段著作权人或主体标识。
file_id / hash参考字段关联上传文件或业务数据摘要。
scene参考字段版权、消费数据、农业溯源、医疗健康、门店等场景分类。
POST
/api/cert/querycert_id参考字段存证或证书编号。
chain_id参考字段链上交易或区块记录标识。
联调与商用接入说明
- 公开文档页面未完整展开所有业务字段，站内展示字段为售前理解和方案设计参考，正式请求字段以联调文档和接口返回为准。
- 客户系统应保留原始业务数据、授权材料、请求日志和返回结果，便于后续核验和审计。
- 医疗健康、个人信息和敏感数据场景应优先提交摘要、编号和必要字段，不应未经授权上传敏感原文。
- API 技术服务费用可按接口数量、联调复杂度、证书模板数量和上线支持范围综合报价。