接口功能介绍

通过本接口可获取存放在媒体存储、云点播存储桶内的音视频文件的元数据信息，可同时适用于点播模式和托管模式。由于获取元数据信息需要较长时间拉取文件样本，为保证业务流程运转流畅，本接口被设定为异步调用方式。用户在接口中仅需提供源文件访问地址（必须为云点播、媒体存储产品合法的存储桶地址），后台在接收到请求后，会通过HTTP POST方法将结果(JSON格式)返回。异步回调数据格式可参考以下文档。

接口约束

本接口的单用户QPS限制为20次/秒。超过限制，API调用会被限流，这可能会影响您的业务，请合理调用。

URI

POST /metadata/task

请求体body参数

响应参数

表data

请求示例

{
    "visitUrl": "https://bucketname.gdoss.xstore.ctyun.cn/video.mp4",
    "clientCallbackUrl": "https://callback.ctyun.cn/Callback"
}

响应示例

{
  "code":"0",
  "message":"",
  "data": {
     "taskId": "c39c5d5b11b849508f3a9b98a27d1310"
  }
}

状态码

错误码

OpenAPI错误码请参考 错误码说明。