# 示例3：获取媒资详情
#### 场景描述
若您需要查询一个或多个媒资的基本信息、转码文件生成信息、截图信息及审核信息，您可以调用VOD API进行查询。
本章节指导用户如何使用API调用的方式获取存储在VOD中的媒资的详情信息。
#### 前提条件
- 已明确需要查询的媒资所在区域信息，详见[使用前必读](https://support.huaweicloud.com/api-vod/vod_04_0042.html)。
- 已获取需要查询的媒资所在区域的项目ID，具体获取方法请参见[获取项目ID](https://support.huaweicloud.com/api-vod/vod_04_0211.html)。
 
#### 总体流程
1. [获取用户Token]
2. [查询媒资详细信息]
 
#### 操作步骤
1. [获取用户Token](https://support.huaweicloud.com/api-iam/iam_30_0001.html)，用于调用点播接口时进行认证鉴权。
   
   详细信息请参见[构造请求](https://support.huaweicloud.com/api-vod/vod_04_0108.html)。以"华北-北京四"为示例，若您需要调用其它区域的点播接口，请替换成对应区域的[IAM终端节点](https://console.huaweicloud.com/apiexplorer/#/endpoint/VOD)。
   ```
   POST https://iam.cn-north-4.myhuaweicloud.com/v3/auth/tokens
   Content-Type: application/json
   {
     "auth": {
       "identity": {
         "methods": [
           "password"
         ],
         "password": {
           "user": {
             "name": "username", 
             "password": "password", 
             "domain": {
               "name": "domainname"   
             }
           }
         }
       },
       "scope": {
         "project": {
            "name": "projectname"
         }
       }
     }
   }
   ```
   如[图1]所示，红框中的信息为获取用户Token。
   图1获取用户Token   
   ![](https://support.huaweicloud.com/api-vod/zh-cn_image_0174719076.png)
   
   
2. 调用[查询媒资信息](https://support.huaweicloud.com/api-vod/vod_04_0022.html)接口，查询媒资详情信息。
   
   1. 选择**GET** 请求方法并输入URI。
      ```
      https://{endpoint}/v1.0/{project_id}/asset/details?asset_id=41cff636d5b12a51e7eb2838bbf45201&categories=base_info,transcode_info&thumbnail_info,review_info
      ```
      "categories"为查询媒资信息的类型，您可以选择一个或者多个类型进行查询，具体取值如下所示：
      - base_info：查询媒资基本信息，包含媒资标题、分类、描述、文件类型、原始文件地址等。
      
      - transcode_info：查询媒资转码文件信息，包含使用的转码模板、转码后的媒资信息等。
      
      - thumbnail_info：查询截图信息，包含截图状态、截图存储地址等。
      
      - review_info：审核信息，包含审核是否通过，文本审核结果、封面审核结果和视频审核结果等。
      
      
      ![](https://support.huaweicloud.com/api-vod/public_sys-resources/note_3.0-zh-cn.png)
      仅转码、截图或审核成功时，才可查询到对应的转码信息、截图信息和审核信息。
      
   
   2. 请求消息头中增加"X-Auth-Token"，值设置为[步骤1]中获取的用户Token。
   
   3. 请求响应成功后，返回媒资详情信息。
      ```
      {
        "asset_info_array" : [ {
          "asset_id" : "652c1e4085afeb22fdc256c6757d751b",
          "status" : "PUBLISHED",
          "description" : "Asset meta is published",
          "base_info" : {
            "title" : "okFLV.flv",
            "video_name" : "okFLV.flv",
            "description" : null,
            "category_id" : -1,
            "category_name" : "其他",
            "create_time" : "20190704144303",
            "last_modified" : "20190704144303",
            "video_type" : "FLV",
            "tags" : null,
            "meta_data" : {
              "pack_type" : null,
              "codec" : "H.264",
              "duration" : 244,
              "video_size" : 13682041,
              "width" : 512,
              "hight" : 288,
              "bit_rate" : 448,
              "frame_rate" : 30,
              "quality" : null
            },
            "video_url" : "https://651.cdn-vod.huaweicloud.com/asset/652c1e4085afeb22fdc256c6757d751b/45c2493abe68de3dac7e98b0dadcf8ce.flv",
            "sign_url" : "",
            "cover_info_array" : [ {
              "cover_url" : "https://651.cdn-vod.huaweicloud.com/asset/652c1e4085afeb22fdc256c6757d751b/cover/Cover0.jpg"
            } ],
            "subtitle_info" : [ ],
            "source_path" : {
              "bucket" : "obs-host",
              "location" : "cn-north-4",
              "object" : "1/okFLV.flv"
            },
            "output_path" : {
              "bucket" : "obs-host",
              "location" : "cn-north-4",
              "object" : "output/652c1e4085afeb22fdc256c6757d751b/"
            }
          },
          "play_info_array" : [ {
            "play_type" : "hls",
            "url" : "https://651.cdn-vod.huaweicloud.com/asset/652c1e4085afeb22fdc256c6757d751b/play_video/index.m3u8",
            "encrypted" : 0,
            "meta_data" : {
              "pack_type" : null,
              "codec" : "H.264",
              "duration" : 0,
              "video_size" : 0,
              "width" : 0,
              "hight" : 0,
              "bit_rate" : 0,
              "frame_rate" : 0,
              "quality" : null
            }
          }, {
            "play_type" : "hls",
            "url" : "https://651.cdn-vod.huaweicloud.com/asset/652c1e4085afeb22fdc256c6757d751b/play_video/b5d498082bbcff7a2055041d803ae2f9_1.m3u8",
            "encrypted" : 0,
            "meta_data" : {
              "pack_type" : null,
              "codec" : "H.264",
              "duration" : 205,
              "video_size" : 14669824,
              "width" : 512,
              "hight" : 288,
              "bit_rate" : 534,
              "frame_rate" : 0,
              "quality" : null
            }
          } ]
        } ],
        "is_truncated" : 0,
        "total" : 1
      }
      {
        "asset_info_array" : [ {
          "asset_id" : "652c1e4085afeb22fdc256c6757d751b",
          "status" : "PUBLISHED",
          "description" : "Asset meta is published",
          "base_info" : {
            "title" : "okFLV.flv",
            "video_name" : "okFLV.flv",
            "description" : null,
            "category_id" : -1,
            "category_name" : "其他",
            "create_time" : "20190704144303",
            "last_modified" : "20190704144303",
            "video_type" : "FLV",
            "tags" : null,
            "meta_data" : {
              "pack_type" : null,
              "codec" : "H.264",
              "duration" : 244,
              "video_size" : 13682041,
              "width" : 512,
              "hight" : 288,
              "bit_rate" : 448,
              "frame_rate" : 30,
              "quality" : null
            },
            "video_url" : "https://651.cdn-vod.huaweicloud.com/asset/652c1e4085afeb22fdc256c6757d751b/45c2493abe68de3dac7e98b0dadcf8ce.flv",
            "sign_url" : "",
            "cover_info_array" : [ {
              "cover_url" : "https://651.cdn-vod.huaweicloud.com/asset/652c1e4085afeb22fdc256c6757d751b/cover/Cover0.jpg"
            } ],
            "subtitle_info" : [ ],
            "source_path" : {
              "bucket" : "obs-host",
              "location" : "cn-north-4",
              "object" : "1/okFLV.flv"
            },
            "output_path" : {
              "bucket" : "obs-host",
              "location" : "cn-north-4",
              "object" : "output/652c1e4085afeb22fdc256c6757d751b/"
            }
          },
          "play_info_array" : [ {
            "play_type" : "hls",
            "url" : "https://651.cdn-vod.huaweicloud.com/asset/652c1e4085afeb22fdc256c6757d751b/play_video/index.m3u8",
            "encrypted" : 0,
            "meta_data" : {
              "pack_type" : null,
              "codec" : "H.264",
              "duration" : 0,
              "video_size" : 0,
              "width" : 0,
              "hight" : 0,
              "bit_rate" : 0,
              "frame_rate" : 0,
              "quality" : null
            }
          }, {
            "play_type" : "hls",
            "url" : "https://651.cdn-vod.huaweicloud.com/asset/652c1e4085afeb22fdc256c6757d751b/play_video/b5d498082bbcff7a2055041d803ae2f9_1.m3u8",
            "encrypted" : 0,
            "meta_data" : {
              "pack_type" : null,
              "codec" : "H.264",
              "duration" : 205,
              "video_size" : 14669824,
              "width" : 512,
              "hight" : 288,
              "bit_rate" : 534,
              "frame_rate" : 0,
              "quality" : null
            }
          } ]
        } ],
        "is_truncated" : 0,
        "total" : 1
      }
      ```