获取指定任务对应的帧信息接口
### 获取指定任务对应的帧信息接口
可根据任务id获取到任务所对应的帧的信息,用于数据同步或数据对比等操作
**请求URL：**
- `https://www.speedyrender.cn:8890/api/v1/kuaixuan/agency/task/frameinfo`
**请求方式：**
- POST
**请求示例**
```
{
"agencyid":"M4JUWRUQ",
"data":"{"taskid":67678}",
"sign":"1e1b30b62041dbcadb49e2482c3bd801861c175b328a4506f04b5a4760b5f45db29f09822cae8942a700f470e15bec8e18e53cb61dd2717116504c8bd16971691f5477cb7eadf413264db332cd577b4b6998306da3b29c2b79a4dd1087bad731fe79fb9378101be351a0ebf49293a4d07ad506cd34904a109f521664b9aec268e45efb0e7c55c7cd1225027c461f8e38866cd4b6b1dc692593b15b8a49514825f9eb70cc6d0d1125fef860552a293e6bfaff1003269ca93982e098efa2350175985dea7d3d4b3d03146fe25c395d7aeafe34190e03e2a80329b435f9769469bcc22fd8111cadb29e4b3f84a5c0d01d1bc59c7fe7283179a97264d2d30470f73d"
}
```
|参数名|必选|类型|说明|
|:---- |:---|:----- |----- |
|data|是 |string |任务创建时间 createtime int64类型 |
|agencyid|是|string|经销商id号|
|sign |是 |string |由经销商的私钥和data生成的签名|
data中信息如下:
|参数名|必选|类型|说明|
|:---- |:---|:----- |----- |
|taskid |是 |int64 |任务id |
**返回值**
```
{
"data": [
{
"action": 4,
"agencyuserid": 3,
"files": [
{
"name": "/2019-11-15/67678-03-Ik-joe--Spline-IK--frames/000_kx_vray_framebuf.Alpha.0003.TGA",
"size": 12539
},
{
"name": "/2019-11-15/67678-03-Ik-joe--Spline-IK--frames/000_kx_vray_framebuf.RGB_color.0003.TGA",
"size": 673207
},
{
"name": "/2019-11-15/67678-03-Ik-joe--Spline-IK--frames/A-0003.TGA",
"size": 672162
}
],
"frameindex": 3,
"gross": 2,
"id": 295716,
"lightjobgross": 5,
"lightjobrendertimethread": 768,
"lightjobstatus": 5,
"owner": 0,
"ownername": "18330748166",
"rendertaskid": 67678,
"rendertimethread": 288,
"status": 5,
"type": 0
},
{
"action": 4,
"agencyuserid": 3,
"files": [
{
"name": "/2019-11-15/67678-03-Ik-joe--Spline-IK--frames/000_kx_vray_framebuf.Alpha.0001.TGA",
"size": 12539
},
{
"name": "/2019-11-15/67678-03-Ik-joe--Spline-IK--frames/000_kx_vray_framebuf.RGB_color.0001.TGA",
"size": 673277
},
{
"name": "/2019-11-15/67678-03-Ik-joe--Spline-IK--frames/A-0001.TGA",
"size": 672223
}
],
"frameindex": 1,
"gross": 1,
"id": 295717,
"lightjobgross": 0,
"lightjobrendertimethread": 0,
"lightjobstatus": 0,
"owner": 0,
"ownername": "18330748166",
"rendertaskid": 67678,
"rendertimethread": 240,
"status": 5,
"type": 0
},
{
"action": 4,
"agencyuserid": 3,
"files": [
{
"name": "/2019-11-15/67678-03-Ik-joe--Spline-IK--frames/000_kx_vray_framebuf.Alpha.0002.TGA",
"size": 12539
},
{
"name": "/2019-11-15/67678-03-Ik-joe--Spline-IK--frames/000_kx_vray_framebuf.RGB_color.0002.TGA",
"size": 673215
},
{
"name": "/2019-11-15/67678-03-Ik-joe--Spline-IK--frames/A-0002.TGA",
"size": 672352
}
],
"frameindex": 2,
"gross": 2,
"id": 295718,
"lightjobgross": 0,
"lightjobrendertimethread": 0,
"lightjobstatus": 0,
"owner": 0,
"ownername": "18330748166",
"rendertaskid": 67678,
"rendertimethread": 288,
"status": 5,
"type": 0
}
],
"error": 0,
"errormsg": "success",
"extramsg": null,
"id": 0
}
```
**返回参数说明**
|参数名|类型|说明|
|:----- |:-----|----- |
|error | int |0:成功|
|errormsg|string |success|
|id | int64 |无意义|
|data |json |任务的帧信息|
data中的信息
|字段|类型|注释|
|:---- |:------- |:---
|ID |int64 |唯一id|
|Owner |int64 |用户在我方库中的id|
|OwnerName |string |用户名|
|AgencyUserID |int64 |在经销商库中的id|
|RenderTaskID |int64 |所属任务id|
|FrameIndex |int |帧索引|
|Status |int |渲染状态|
|RenderTimeThread |int64 |线程时|
|Gross |int64 |帧的费用|
|Files |[]fileObject |输出文件|
|Type |int | 0: 动画, 1: 效果图|
|Action |int |同步数据的操作: 0创建任务,1 更新任务状态,2任务完成并扣费,3任务删除操作|
|LightJobGross |int64 | 小光子任务最终费用|
|LightJobRenderTimeThread|int64 | 小光子渲染的线程时|
|LightJobStatus |int | 小光子任务状态|
- FileObject结构体
```
type FileObject struct {
//文件的名称,可用于下载已完成文件,下载完成文件可参考:快渲经销商Api文档-任务已完成文件下载接口
Name string `json:"name"`
//文件大小（字节）
Size int64 `json:"size"`
}
```