# 数据登记

将哈希值进行登记确权。

# URL

[POST] /v2/apps/{app_id}/hashes?signature={signature}&timestamp={timestamp}

# Query参数

名称	是否必填	说明
app_id	是	企业应用的App ID
signature	是	请求URL的签名。详见接口认证签名方法。
timestamp	是	当前时间戳。精确到秒。详见接口认证签名方法。

# Body参数

Body参数以JSON格式传输

名称	必填	说明
hash	是	原始数据的哈希值。详见哈希计算注意事项。
type	是	数字资产类型： 1：创意作品（视听文学作品） 2：创意设计（品牌徽标、图案、织物、建筑等） 3：工业品外观设计（技术原理图、详图、工艺流程等） 4：代码（用于软件、应用程序、游戏等） 5：研究（实验室记录、报告等发现） 6：数据（AI建模、基因测序等） 7：有数字签名的文件（合同、信件、证书等） 8：其它（例如，损害资料或未签名文件） 9：商业秘密

# 返回值

当接口调用正常完成时，返回200状态码。Body中为JSON格式的数字财产数据。详情参考接口返回值说明。

注意数字财产登记为异步过程，但是登记接口的调用是同步的。在登记接口返回的数字财产数据中包含一个status字段，表示登记的状态。登记接口返回时的状态是“登记中”。过一段时间后变为“登记成功”。可使用数据查询接口查询最新的数字财产登记状态。

# 调用示例

# 示例数据

app_id: 1583379053837029376
app_secret: UgHWn1Cd0lEdNOZV6a2FpOaL3b5HFDbU
hash: 85ca20b5ff6c404e75426f7b14caef6cfee82b0ae3822ae56e3a674856afbf6f
timestamp: 1666341958
type: 4

# 请求体

[POST] https://api.ip.hetutec.com/v2/apps/1583379053837029376/hashes?signature=a7feff32026eb4dd4b36b0f384696c74745cb6ddb6754d54c2645fd75cfcc043&timestamp=1666341958

[Body]
{
   "hash":"85ca20b5ff6c404e75426f7b14caef6cfee82b0ae3822ae56e3a674856afbf6f",
   "type":4
}

# 成功样例

[200]
{
    "hash": "85ca20b5ff6c404e75426f7b14caef6cfee82b0ae3822ae56e3a674856afbf6f",
    "type": 4,
    "status": 2,
    "algorithm": "zkp",
    "app_id": 1583378399215226880
}

# 失败样例

[400]
{
    "field_name": "app_id",
    "message": "app not found"
}