# 华为云录制信息回调（API名称：vodCallBack）
#### 功能介绍
仅供华为云订阅，用于录制信息回调。
#### 相关接口
| **接口名称**                                                             | **调用说明**                                                     |
|:---|:---|
| [获取Token](https://support.huaweicloud.com/api-isdp/api_01_0019.html) | 调用该接口获取到Token，再调用其他接口时，需要在请求消息头中添加"Authorization"，其值即为Token。 |
   
#### URL
| **请求方式** | **HTTPS地址**                                                | **服务架构** | **消息体类型**        |
|:---|:---|:---|:---|
| POST     | https://***isdp+域名***/openapi/v1/ivmAlarm/Live/vodCallBack | OpenAPI  | application/json |
   
#### 请求头
| **KEY**       | VALUE                  | 是否必填 | **描述**                                                                                           |
|:---|:---|:---|:---|
| Content-Type  | application/json       | 是    | 无                                                                                                |
| Authorization | bearer ${access_token} | 是    | bearer +" "+[5.2.1](https://support.huaweicloud.com/api-isdp/api_01_0019.html)中获取的access_token的值 |
   
#### 请求参数
| **参数**          | **类型** | **是否必填** | **描述** |
|:---|:---|:---|:---|
| project_id      | String | 是        | 项目ID   |
| publish_domain  | String | 是        | 推流域    |
| event_type      | String | 是        | 事件类型   |
| app             | String | 是        | 应用     |
| stream          | String | 否        | 流      |
| record_format   | String | 否        | 录制格式   |
| download_url    | String | 否        | 下载地址   |
| asset_id        | String | 否        | 媒资ID   |
| play_url        | String | 否        | 回放地址   |
| file_size       | Int    | 否        | 文件大小   |
| record_duration | Int    | 否        | 录制时长   |
| start_time      | String | 否        | 开始录制时间 |
| end_time        | String | 否        | 结束录制时间 |
| width           | String | 否        | 视频宽    |
| heigh           | String | 否        | 视频高    |
| obs_location    | String | 否        | OBS位置  |
| obs_bucket      | String | 否        | OBS桶   |
| obs_object      | String | 否        | OBS对象  |
   
#### 响应参数
| **字段名** | **数据类型** | **描述**         |
|:---|:---|:---|
| status  | int      | 返回状态：0-成功;1-失败 |
| message | String   | 返回的失败消息。       |
   
#### 请求示例
```
{
    "project_id": "08c3fefc440026372f7bc0124f939428",
    "publish_domain": "pushsit.xxxx.com",
    "event_type": "RECORD_FILE_COMPLETE",
    "app": "live",
    "stream": "886_142279",
    "record_format": "FLV",
    "download_url": "https://isdp-video-test.obs.cn-north-4.xxxx.com/push_sit/Record/pushsit.gupiaoai.com/live/continuous_record/flv/886_142279_2020-08-17-09-30-16/886_142279_2020-08-17-09-30-16.flv",
    "asset_id": "afa6d03092982644bb25ef1f1a3da269",
    "play_url": "https://2084-cn-north-4.cdn-vod.xxxx.com/asset/afa6d03092982644bb25ef1f1a3da269/750a79d9bbde60860404aeaf4b61d8b4.flv",
    "file_size": 33406499,
    "record_duration": 403,
    "start_time": "2020-08-17T09:30:16Z",
    "end_time": "2020-08-17T09:37:06Z",
    "width": 854,
    "height": 480,
    "obs_location": "https://obs.cn-north-4.xxxx.com",
    "obs_bucket": "isdp-video-test",
    "obs_object": "push_sit/Record/pushsit.xxxx.com/live/continuous_record/flv/886_142279_2020-08-17-09-30-16/886_142279_2020-08-17-09-30-16.flv"
}
```
#### 响应示例
```
{
    "status": 1,
    "message": "SUCCESS",
    "error": null,
    "data": "ok",
    "timestamp": "2021-03-15T13:46:34.805+0800"
}
```