添加防盗指纹 - 歌者 Open API

请求参数

Body 参数multipart/form-data

file

string

可选

直接上传文件，需小于 30M，（file/fileURL 必须二选一，不能同时为空，也不能同时有值)，支持 pptx格式文件

fileURL

string

可选

文件访问 URL，需小于 500M，（file/fileURL 必须二选一，不能同时为空，也不能同时有值)，支持 pptx 格式文件

isSync

boolean

可选

是否同步调用，默认为 true

extra

string

可选

自定义信息，长度不超过 1024 个字符

notifyURL

string

可选

接受任务状态变更的回调地址

示例代码

Shell

JavaScript

Java

Swift

Go

PHP

Python

HTTP

C

C#

Objective-C

Ruby

OCaml

Dart

R

curl --location --request POST 'https://api.gezhe.com/v1/certs' \
--form 'file=""' \
--form 'fileURL=""' \
--form 'isSync=""' \
--form 'extra=""' \
--form 'notifyURL=""'

返回响应

🟢200成功

application/json

Body

id

string

任务 ID

必需

ID 编号

userId

string

必需

name

string

文件名

必需

status

string

任务状态

必需

默认为同步任务，值固定为 done

extra

string

必需

自定义附带的信息，校验防盗指纹时，可以查询到

createdAt

string

任务创建时间

必需

updatedAt

string

任务最后更新时间

必需

target

array [oneOf]

必需

string

下载地址

可选

添加完水印的文件下载地址，需要在 24h 内完成下载

integer

文件大小

可选

string

文件哈希值

可选

errorMsg

null

错误信息

必需

errorCode

null

错误码

必需

示例

{
  "userId": "UR5ynd8",
  "id": "UR5ynd8S250106pZHMuh",
  "name": "XXX 发布会.pptx",
  "status": "done",
  "extra": "{'text':'hello world'}",
  "creatorId": "WwMezp0D",
  "target": [
    "https://slave-dev-02.gezhe.com/_files/2025-01/e8/e8483ee4-980f-4b4c-b25c-febd537942f31.pptx",
    932362,
    "0a161ea9c0a7f2f44db28c7fd6e0f914"
  ],
  "notifyURL": null,
  "notifyCount": 0,
  "createdAt": "2025-01-06T06:07:26.000Z",
  "updatedAt": "2025-01-06T06:07:27.000Z",
  "errorCode": null,
  "errorMsg": null
}