查询人脸异步下发任务状态

GET

https://api2.hik-cloud.com/api/v1/open/intelligents/faceLibs/actions/getAsyncTaskStatus

接口描述
单个任务状态查询

请求示例

Shell

JavaScript

Java

Swift

curl --location --request GET 'https://api2.hik-cloud.com/api/v1/open/intelligents/faceLibs/actions/getAsyncTaskStatus' \
--header 'Authorization: Bearer '

响应示例

{
    "code": 200,
    "message": "操作成功",
    "data": {
        "customFaceLibId": "111",
        "taskId": "xxxxxxxxx",
        "status": 0,
        "state": "URLError",
        "progress": 100
    }
}

请求参数

Query 参数

deviceSerial

string

设备序列号

可选

示例值:

xxxxx

taskId

string

任务ID

可选

示例值:

xxxxxx

Header 参数

Authorization

string

可选

默认值:

Bearer {{access_token}}

返回响应

🟢200成功

application/json

Body

code

integer

返回码

必需

message

string

返回信息

必需

data

object

返回数据对象

可选

customFaceLibId

string

自定义人脸库ID

必需

taskId

string

任务ID

必需

status

integer

任务执行状态, 0为未执行，1为执行中，2为执行异常(只包括解析过程，不包括图片下载和建模过程)，3为执行完成(某张图片下载建模失败，会继续执行，直到所有的图片建模完成)

必需

state

string

依赖status=2时不为空，任务执行异常原因描述(URLError-文件url错误，networkError-网络错误，certifyFailed-鉴权失败，parseFileError-解析文件错误，insufficientFaceLibCapacity-人脸库容量不足，unknown-未知错误)

可选

progress

integer

任务进度，100-表示完成（数据文件中的所有URL对应的图片入库和建模动作完成）0-表示尚未开始。当status为2和3时，该进度都为100

必需

修改于 2022-05-25 09:20:34

人脸批量异步下发

查询人脸异步下发所有任务状态