edit-icon download-icon

QueryMediaListByURL

Last Updated: May 04, 2018

Description

The QueryMediaListByURL API queries media sets by OSS file URLs.

Request parameters

Parameter Type Required or not Description
Action String Yes API of the action, system required parameter. Set this parameter to QueryMediaListByURL.
FileURLs String Yes A list of file URLs separated by commas (,). A maximum of 10 file URLs can be entered. The URL format follows the RFC 3986 standard. (The URL is encoded by UTF-8 and the reserved characters are URL encoded characters.) A URL consists of up to 3,200 bytes.
IncludePlayList Boolean No Whether the results contain a playlist. Optional values: True/False; default value: False.
IncludeSnapshotList Boolean No Whether the results contain a screenshot list. Optional values: True/False; default value: False.
IncludeMediaInfo Boolean No Whether the results contain media information. Optional values: True/False; default value: False.

Return parameters

Name Type Description
MediaList Media[] Media list
NonExistFileURLs String[] A list of nonexistent media resources

Example

Request example

  1. http://mts.cn-hangzhou.aliyuncs.com?FileURLs=http%3A%2F%2Fzzzinput-test.oss-cn-hangzhou.aliyuncs.com%2Foutput-2016-01-07-09%253A37%253A17.mp485191.mp4&<public parameter>

Return example

XML

  1. <QueryMediaListByURLResponse>
  2. <MediaList>
  3. <Media>
  4. <CoverURL>http://zzyoutputbucket.oss-cn-hangzhou.aliyuncs.com/47b42486019c4f688bf144c1a6ba059a%2F0.jpg</CoverURL>
  5. <Format>mov,mp4,m4a,3gp,3g2,mj2</Format>
  6. <PublishState>Published</PublishState>
  7. <File>
  8. <State>Normal</State>
  9. <URL>http://zzzinput-test.oss-cn-hangzhou.aliyuncs.com/output-2016-01-07-09%3A37%3A17.mp485191.mp4</URL>
  10. </File>
  11. <Height>1080</Height>
  12. <MediaId>3e1cd21131a94525be55acf65888bf46</MediaId>
  13. <Title>output-2016-01-07-09:37:17.mp485191.mp4</Title>
  14. <CreationTime>2016-09-14T08:30:33Z</CreationTime>
  15. <RunIdList>
  16. <RunId>47b42486019c4f688bf144c1a6ba059a</RunId>
  17. </RunIdList>
  18. <CateId>0</CateId>
  19. <MediaInfo>
  20. <Format/>
  21. <Streams/>
  22. </MediaInfo>
  23. <Duration>7.965000</Duration>
  24. <Width>1920</Width>
  25. <Fps>25.0</Fps>
  26. <Bitrate>2659.326</Bitrate>
  27. <Size>2647692</Size>
  28. </Media>
  29. </MediaList>
  30. <RequestId>135F7C8D-1E90-4163-8475-15497039B59D</RequestId>
  31. <NonExistFileURLs/>
  32. </QueryMediaListByURLResponse>

JSON

  1. {
  2. "MediaList": {
  3. "Media": [
  4. {
  5. "CoverURL": "http://zzyoutputbucket.oss-cn-hangzhou.aliyuncs.com/47b42486019c4f688bf144c1a6ba059a%2F0.jpg",
  6. "Format": "mov,mp4,m4a,3gp,3g2,mj2",
  7. "PublishState": "Published",
  8. "File": {
  9. "State": "Normal",
  10. "URL": "http://zzzinput-test.oss-cn-hangzhou.aliyuncs.com/output-2016-01-07-09%3A37%3A17.mp485191.mp4"
  11. },
  12. "Height": "1080",
  13. "MediaId": "3e1cd21131a94525be55acf65888bf46",
  14. "Title": "output-2016-01-07-09:37:17.mp485191.mp4",
  15. "CreationTime": "2016-09-14T08:30:33Z",
  16. "RunIdList": {
  17. "RunId": [
  18. "47b42486019c4f688bf144c1a6ba059a"
  19. ]
  20. },
  21. "CateId": 0,
  22. "MediaInfo": {
  23. "Format": { },
  24. "Streams": { }
  25. },
  26. "Duration": "7.965000",
  27. "Width": "1920",
  28. "Fps": "25.0",
  29. "Bitrate": "2659.326",
  30. "Size": "2647692"
  31. }
  32. ]
  33. },
  34. "RequestId": "96E71ED6-491D-4515-9AB2-AB06AFF71F70",
  35. "NonExistFileURLs": {
  36. "FileURL": [ ]
  37. }
  38. }
Thank you! We've received your feedback.