批量查询任务

批量查询多个项目的任务状态。

基本信息

项目	值
方法	GET
路径	/v2/aholo/project/task/batch
认证	签名认证（appkey + timestamp + sign）

Request

Query Param

参数	必须	类型	说明
appkey	✅	string	商家 appkey
timestamp	✅	string	时间戳（毫秒）
sign	✅	string	签名值
appuid	❌	string	第三方用户 ID
projectIds	✅	string	项目 ID 列表，逗号分隔

签名计算

sign = md5(appsecret + appkey + appuid + timestamp)

如果不需要 appuid：

sign = md5(appsecret + appkey + timestamp)

Example

curl

curl -X GET 'https://openapi.kujiale.com/v2/aholo/project/task/batch?appkey=YOUR_APPKEY&timestamp=1485878400000&sign=YOUR_SIGN&projectIds=id1,id2,id3'

Python

import hashlib
import time
import requests

appkey = "YOUR_APPKEY"
appsecret = "YOUR_APPSECRET"
project_ids = "id1,id2,id3"

timestamp = str(int(time.time() * 1000))
sign_str = appsecret + appkey + timestamp
sign = hashlib.md5(sign_str.encode()).hexdigest()

url = "https://openapi.kujiale.com/v2/aholo/project/task/batch"
params = {
    "appkey": appkey,
    "timestamp": timestamp,
    "sign": sign,
    "projectIds": project_ids
}

response = requests.get(url, params=params)

Response

{
  "c": "0",
  "d": [
    {
      "projectId": "id1",
      "task": {
        "status": 3,
        "result": { "plyPath": "...", "spzPath": "...", "sogPath": "..." }
      }
    },
    {
      "projectId": "id2",
      "task": {
        "status": 1
      }
    }
  ]
}

任务状态枚举

Status	含义	是否终态
0	排队中，任务还未被提交	否
1	结束排队，等待被执行，任务已被提交	否
2	执行中	否
3	成功	是
4	失败	是
5	取消	是
6	超时	是
7	被拒绝	是
8	预处理中	否

使用结果

当 status === 3（成功）时，可从 result 中获取 3D 文件下载链接。 推荐使用 .spz 或 .sog 格式。