GET api/v1/match?fileName={fileName}&hash={hash}&length={length}&duration={duration}&force={force}

使用指定的文件名、Hash、文件长度信息寻找文件可能对应的节目信息。

请求信息

参数

名称说明备注
fileName
视频文件名,不包含文件夹名称和扩展名,特殊字符需进行转义

此参数包含在URI中提交.

hash
文件前16MB(16x1024x1024Byte)数据的32位MD5结果,不区分大小写

此参数包含在URI中提交.

length
文件总长度,单位为Byte。

此参数包含在URI中提交.

duration
[可选参数]32位整数的视频时长,单位为秒。默认为0

此参数包含在URI中提交.

force
[可选参数]强制使用一个模式进行匹配。默认为0(不启用),设置为1将使用文件名(不使用MD5)匹配,设置为2将使用MD5(不使用文件名)匹配。

此参数包含在URI中提交.

备注

此API首先会使用Hash信息进行搜寻,如果有相应的记录,会返回“精确关联”的结果。如果Hash信息查找失败,则会通过文件名查找。

返回信息

返回值说明

一个包含节目信息的列表,节目在列表中排名越靠前,这个节目越有可能是视频文件的内容。
当列表中只有一个节目时,视为“精确关联” —— 说明此视频已被人工关联了某一节目。客户端应自动选择这个结果,不必再让用户做出选择。

返回格式

application/json, text/json

示例:
{
  "Matches": [
    {
      "EpisodeId": 1,
      "AnimeTitle": "sample string 2",
      "EpisodeTitle": "sample string 3",
      "Type": 4,
      "Shift": 5.1
    },
    {
      "EpisodeId": 1,
      "AnimeTitle": "sample string 2",
      "EpisodeTitle": "sample string 3",
      "Type": 4,
      "Shift": 5.1
    },
    {
      "EpisodeId": 1,
      "AnimeTitle": "sample string 2",
      "EpisodeTitle": "sample string 3",
      "Type": 4,
      "Shift": 5.1
    }
  ]
}

application/xml, text/xml

示例:
<Matches xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns="http://schemas.datacontract.org/2004/07/CornService.Models">
  <Match EpisodeId="1" AnimeTitle="sample string 2" EpisodeTitle="sample string 3" Type="4" Shift="5.1" />
  <Match EpisodeId="1" AnimeTitle="sample string 2" EpisodeTitle="sample string 3" Type="4" Shift="5.1" />
  <Match EpisodeId="1" AnimeTitle="sample string 2" EpisodeTitle="sample string 3" Type="4" Shift="5.1" />
</Matches>