任务查询
描述
本接口用于云端查询任务状态的请求，具体效果请看以下文档详情。
版本
1.0
注意
提交的任务在24小时后会过期，过期的任务的查询结果为空。 不支持历史任务查询。 如需要保存任务信息，请自行保存任务相关信息。
调用 URL
https://openapi.meitu.com/api/v1/sdk/status?task_id={task_id}
调用方法
GET
签名验证
权限
使用前需提前申请 APPKEY 和 SECRETID。
请求参数
| 是否必选 | 参数名 | 类型 | 参数说明 |
|---|---|---|---|
| 必选 | task_id | string | 任务ID |
| 可选 | context | string | 客户端上下文信息 格式 v1:base64(data)，v1 为版本号，v1 定义为json格式。 |
输入值示例
taskid示例：t_mt1a3i5n7baf2b7e89-7f37-47a9-9085-9b406263c260返回值说明
成功返回值说明
| 字段 | 类型 | 参数说明 |
|---|---|---|
| data | Object | 返回的内容 |
| message | String | 错误信息 |
| code | Number | 错误代码 |
data 中单个元素的字段说明
| 字段 | 类型 | 参数说明 |
|---|---|---|
| status | Number | 状态码，-1没有找到任务，0任务创建成功，1 任务执行中，2任务失败，10任务成功。 |
| msg | String | 多媒体文件的相关属性信息描述 |
| result | Object | 结果 |
| progress | Number | 任务进度，例如：0.1 、0.85、1。 |
data.result 中单个元素的字段说明
| 字段 | 类型 | 参数说明 |
|---|---|---|
| id | String | 任务ID |
| urls | String[] | 图片地址 |
失败返回值说明
| 字段 | 类型 | 说明 |
|---|---|---|
| data | String | 返回的内容 |
| message | String | 错误信息 |
| code | Int | 错误代码 |
返回值示例
请求成功返回示例
Response Status：200
content-type 为 application/json; charset=utf-8
{
"code": 0,
"message":"",
"data": {
"status": 10,
"result": {
"id": "50309bd5-a827-4125-bc96-62039c93770b",
"urls": ["https: //obs.mtlab.meitu.com/mtopen/rF5GIhp5ReLKgLV91CKj5BO1q2FTLMmc/MTY5Mjg1MzIwMA==/1c39ef92-04f1-40b4-5b7e-8fcfca0c11ea.png"]
},
"progress": 1
}
}请求失败返回示例
Response Status：400
content-type 为 application/json; charset=utf-8
{
"code": 20008,
"message": "UNSUITABLE_IMAGE",
"data": null
}