VIP视频解析

1. 概述

极速解析接口用于将用户提交的视频播放页地址解析为可直接播放的流媒体地址，解析支持：优酷、爱奇艺、腾讯、芒果、乐视、搜狐等等，供播放器或下载器使用。

接口地址：https://www.yuntts.com/api/v1/jiexi

请求方式：POST

请求体格式：application/json

认证方式：Bearer Token（Authorization 请求头）

说明：普通用户每次请求扣除 2 点余额，VIP 及以上会员免费调用。

2. 请求头说明

字段名称	数据类型	是否必填	说明
`Authorization`	string	是	认证凭证，格式为 `Bearer <API Key>`，其中 `<API Key>` 为平台分配的访问密钥
`Content-Type`	string	是	请求体媒体类型，固定为 `application/json`

3. 请求参数列表

参数名称	数据类型	是否必填	取值范围	说明
`url`	string	是	合法的 `http/https` URL	待解析的视频播放页地址，需为完整 URL
`line`	integer	否	`1` 或 `2`，默认 `1`	解析线路编号。线路 `1` 为默认线路，线路 `2` 为备用线路；当某条线路解析失败时，可尝试切换另一条线路

4. 请求示例

4.1 cURL 示例

4.2 原始 HTTP 请求示例

5. 返回结果说明

5.1 通用返回结构

字段名称	数据类型	说明
`code`	integer	状态码，与 HTTP 状态码一致，`200` 表示成功
`message`	string	提示信息（成功时返回）
`data`	object	解析结果数据（仅成功时返回）
`error`	string	错误代码（仅失败时返回）

5.2 成功响应字段（`data`）

字段名称	数据类型	说明
`title`	string	视频标题
`player`	string	播放器类型标识，固定为 `dplayer`
`type`	string	流媒体类型，固定为 `hls`
`url`	string	解析出的真实播放地址（m3u8）
`success`	string	成功标识，`"1"` 表示解析成功
`tishi`	string	提示信息

5.3 成功示例

{
  "code": 200,
  "message": "解析成功",
  "data": {
    "title": "示例视频标题",
    "player": "dplayer",
    "type": "hls",
    "url": "https://example.com/stream/xxxx.m3u8?token=xxxx",
    "success": "1",
    "tishi": "提示信息"
  }
}

5.4 失败示例

场景一：缺少 url 参数

{
  "code": 400,
  "error": "invalid_parameter",
  "message": "未提供有效的 url 参数"
}

场景二：line 参数取值非法

{
  "code": 400,
  "error": "invalid_parameter",
  "message": "line 参数仅支持 1/2"
}

场景三：余额不足

{
  "code": 403,
  "error": "insufficient_balance",
  "message": "解析次数不足"
}

场景四：认证失败

{
  "code": 401,
  "error": "rest_invalid_api_key",
  "message": "API密钥无效"
}

6. 错误码说明

HTTP 状态码	错误代码	说明
`400`	`invalid_parameter`	参数缺失或取值非法
`400`	`parse_failed`	解析失败，可尝试更换 `line` 线路重试
`401`	`rest_forbidden`	缺少 `Authorization` 请求头
`401`	`rest_invalid_auth`	`Authorization` 请求头格式错误
`401`	`rest_missing_api_key`	缺少 API 密钥
`401`	`rest_invalid_api_key`	API 密钥无效
`403`	`invalid_user`	用户凭证异常
`403`	`insufficient_balance`	余额（解析次数）不足
`403`	`deduct_failed`	扣费失败，余额不足
`500`	`parse_failed`	服务端解析异常

application/json

Bodyapplication/json

示例

{
    "code": 200,
    "message": "解析成功",
    "data": {
        "title": "示例视频标题",
        "player": "dplayer",
        "type": "hls",
        "url": "https://example.com/stream/xxxx.m3u8?token=xxxx",
        "success": "1",
        "tishi": "提示信息"
    }
}

1. 概述

2. 请求头说明

3. 请求参数列表

4. 请求示例

4.1 cURL 示例

4.2 原始 HTTP 请求示例

5. 返回结果说明

5.1 通用返回结构

5.2 成功响应字段（`data`）

5.3 成功示例

5.4 失败示例

6. 错误码说明

请求参数

请求示例代码

返回响应

VIP视频解析

1. 概述#

2. 请求头说明#

3. 请求参数列表#

4. 请求示例#

4.1 cURL 示例#

4.2 原始 HTTP 请求示例#

5. 返回结果说明#

5.1 通用返回结构#

5.2 成功响应字段（data）#

5.3 成功示例#

5.4 失败示例#

6. 错误码说明#

请求参数

请求示例代码

返回响应

1. 概述

2. 请求头说明

3. 请求参数列表

4. 请求示例

4.1 cURL 示例

4.2 原始 HTTP 请求示例

5. 返回结果说明

5.1 通用返回结构

5.2 成功响应字段（`data`）

5.3 成功示例

5.4 失败示例

6. 错误码说明