跳转至

讲房结果数据通知(回调)

接口说明:

众趣回调客户接⼝,返回讲房生成结果数据(该接⼝由客户提供)。 通常情况下只回调是否成功完成讲房,不会回调讲房的结果数据包(不传数据包相关字段或者为空)。如需数据包需要联系众趣开通。

注意:
  1. 此接口为回调接口,由众趣方主动调用接入方提供的接口地址。
请求方式:
  • POST
Headers:

Content-Type : application/json;charset=UTF-8

传入参数字段及含义:
参数名 是否必须 参数类型 参数描述
nest_id string 模型id
status string 响应状态,可选值 success、failed
task_id string 任务id
oss_file_path_url string 讲房数据包下载地址
file_md5 string ⽂件的MD5值
process_desc string 处理失败时的描述信息
process_desc示例:
process_desc
讲房生成失败
模型数据异常
请求自动化服务失败,请重试
上传数据包出现异常,请检查后重试
成功请求示例:
{
    "nest_id":"b04bf6f8_ocHa_b6f9",
    "status":"success",
    "task_id":"5ff40e41-6e7f-4121-b2ee-0a36b9d19e62",
    "file_md5":"24ff4105cabf53ee7c6814e1ec4bab50",
    "oss_file_path_url":"https://download.3dnest.cn/b04bf6f8_ocHa_b6f9/narration_2022-08-15-08-59-32.zip"
}
失败请求示例:
{
    "nest_id":"b04bf6f8_ocHa_b6f9",
    "status":"failed",
    "task_id":"5ff40e41-6e7f-4121-b2ee-0a36b9d19e62",
    "process_desc":"讲房生成失败"
}
响应规则:

回调接口的响应需要符合回调接口规则中的要求,支持以下两种响应方式:

方式一: 当响应体的Content-Typetext/plain;charset=utf-8时,成功的响应字符串需要为success(忽略大小写)

HTTP/1.1 200 OK
Content-Type: text/plain;charset=utf-8

success

方式二: 当响应体的Content-Typeapplication/json;charset=utf-8时,code=1表示响应成功

{
    "msg": "ok",
    "code": 1
}

如果响应失败,后台服务器会重复进行回调,每次回调间隔为30s, 4m, 30m, 1h