校验防盗指纹 - 歌者 Open API

请求参数

Body 参数multipart/form-data

file

string

可选

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

fileURL

string

可选

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

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/checks' \
--form 'file=""' \
--form 'fileURL=""' \
--form 'notifyURL=""'

返回响应

🟢200成功

application/json

Body

id

string

任务 ID

必需

name

string

文件名称

必需

status

string

必需

isSync

boolean

必需

userId

string

必需

errorCode

null

必需

errorMsg

null

必需

target

array[string]

必需

creatorId

string

必需

notifyURL

null

必需

notifyCount

integer

必需

createdAt

string

必需

updatedAt

string

必需

certs

array [object {13}]

防盗指纹列表

必需

查询到的防盗指纹列表，如果没有当前用户添加的防盗指纹，则会空数组

userId

string

可选

id

string

可选

name

string

可选

status

string

可选

isSync

boolean

可选

extra

string

可选

creatorId

string

可选

notifyURL

null

可选

notifyCount

integer

可选

createdAt

string

可选

updatedAt

string

可选

errorCode

null

可选

errorMsg

null

可选

示例

{
    "userId": "UR5ynd8",
    "id": "UR5ynd8S2501062lNbEn",
    "name": "XXX 发布会.pptx",
    "status": "done",
    "isSync": true,
    "errorCode": null,
    "errorMsg": null,
    "target": [
        "UR5ynd8S250106pZHMuh"
    ],
    "creatorId": "WwMezp0D",
    "notifyURL": null,
    "notifyCount": 0,
    "createdAt": "2025-01-06T06:12:42.000Z",
    "updatedAt": "2025-01-06T06:12:43.000Z",
    "certs": [
        {
            "userId": "UR5ynd8",
            "id": "UR5ynd8S250106pZHMuh",
            "name": "XXX 发布会.pptx",
            "status": "done",
            "isSync": true,
            "errorCode": null,
            "errorMsg": null,
            "extra": "{'text':'Hello world'}",
            "creatorId": "WwMezp0D",
            "notifyURL": null,
            "notifyCount": 0,
            "createdAt": "2025-01-06T06:07:26.000Z",
            "updatedAt": "2025-01-06T06:07:27.000Z"
        }
    ]
}