Skip to content

Latest commit

 

History

History
265 lines (216 loc) · 11.6 KB

videostream_url.md

File metadata and controls

265 lines (216 loc) · 11.6 KB
Raw

课程视频流URL

获取课程视频流URL（web端）

http://api.bilibili.com/pugv/player/web/playurl

请求方式：GET

认证方式：Cookie（SESSDATA）

注：本接口为课程视频专用，故与普通视频不互通

关于视频流会员鉴权：

  • 获取720P及以上清晰度视频时需要登录（Cookie）

  • 获取高帧率（1080P60）/高码率（1080P+）视频时需要有大会员的账号登录（Cookie）

  • 获取正式课程视频（非试看）时需要有已经购买的账号登录（Cookie）

获取的url有效时间为120min，超时失效需要重新获取

部分视频会有分段，需要特别注意

url参数：

参数名 类型 内容 必要性 备注
avid num 课程avID 必要
ep_id num 课程epID 必要
cid num 视频CID 必要
qn num 视频清晰度选择 非必要 未登录默认32（480P）
登录默认64（720P）
值含义见下表
fourk num 是否允许4K视频 非必要 默认为0
画质最高1080P：0
画质最高4K：1

分辨率代码：

值 含义
16 360P 流畅
32 480P 清晰
64 720P 高清（登录）
74 720P60 高清（大会员）
80 1080P 高清（登录）
112 1080P+ 高清（大会员）
116 1080P60 高清（大会员）
120 4K 超清（大会员）

json回复：

根对象：

字段 类型 内容 备注
code num 返回值 0：成功
-400：请求错误
-404：无视频
-403：权限不足（未购买）
message str 错误信息 默认为success
data obj 数据本体

data对象：

字段 类型 内容 备注
accept_format str 视频支持的分辨率的格式
code num 0
durl array 视频分段
seek_param str start
no_rexcode num 0
format str 视频格式
fnval num 0
video_project bool true
fnver num 0
message str 空
type str 视频格式
accept_quality array 视频支持的分辨率列表
quality num 视频分辨率代码 值含义见上表
timelength num 视频长度 单位为毫秒
不同分辨率可能有略微差异
result str suee 作用尚不明确
seek_type str offset 作用尚不明确
has_paid bool false 作用尚不明确
supportFormats array 视频分辨率详细列表
from str local 作用尚不明确
video_codecid num ？？？ 作用尚不明确
accept_description array 视频支持的分辨率列表
status num 0 作用尚不明确

data中的durl数组：

项 类型 内容 备注
0 obj 视频分段1信息
n obj 视频分段(n+1)信息
…… obj ……

durl数组中的对象：

字段 类型 内容 备注
size num 视频大小 单位为Byte
ahead str 空 作用尚不明确
length num 视频长度 单位为毫秒
vhead str 空 作用尚不明确
backup_url array 备用视频流
url str 视频流url 链接有效时间为120min
order num 视频分段序号 某些视频会分为多个片段

durl数组中的对象中的backup_url数组：

项 类型 内容 备注
0 str 备用视频流url 有效时间为120min

data中的supportFormats数组：

项 类型 内容 备注
0 obj 分辨率详细信息1
n obj 分辨率详细信息(n+1)
…… obj …… ……

supportFormats数组中的对象：

字段 类型 内容 备注
format str 分辨率名称
description atr 分辨率备注
quality num 分辨率代码

data中的accept_description数组：

项 类型 内容 备注
0 str 分辨率名称1
n str 分辨率名称(n+1)
…… str …… ……

示例：

获取课程ep790（CID=132105993，avID=76973173）的视频流url，清晰度为1080P60

curl -G 'http://api.bilibili.com/pugv/player/web/playurl'\
--data-urlencode 'ep_id=790'\
--data-urlencode 'avid=76973173'\
--data-urlencode 'cid=132105993'\
--data-urlencode 'qn=116'\
-b 'SESSDATA=xxx'
查看响应示例： 
{
    "code": 0,
    "data": {
        "accept_format": "flv_p60,flv720_p60,flv,flv720,flv480,flv360",
        "code": 0,
        "durl": [
            {
                "size": 1105854161,
                "ahead": "",
                "length": 2222204,
                "vhead": "",
                "backup_url": [
                    "https://upos-sz-mirrorks3c.bilivideo.com/upgcxcode/93/59/132105993/132105993_da2-1-116.flv?e=ig8euxZM2rNcNbNghzTBhwdlhbNz7bUVhoNvNC8BqJIzNbfqXBvEqxTEto8BTrNvN0GvT90W5JZMkX_YN0MvXg8gNEV4NC8xNEV4N03eN0B5tZlqNxTEto8BTrNvNeZVuJ10Kj_g2UB02J0mN0B5tZlqNCNEto8BTrNvNC7MTX502C8f2jmMQJ6mqF2fka1mqx6gqj0eN0B599M=&uipk=5&nbs=1&deadline=1591596728&gen=playurl&os=ks3cbv&oi=606633803&trid=76bea9a9e56f4cb89a9aff2f8213c9acu&platform=pc&upsig=b271bf493bff32ffe62969582c8d18b4&uparams=e,uipk,nbs,deadline,gen,os,oi,trid,platform&mid=0&orderid=1,2&logo=40000000"
                ],
                "url": "https://upos-sz-mirrorks3.bilivideo.com/upgcxcode/93/59/132105993/132105993_da2-1-116.flv?e=ig8euxZM2rNcNbNghzTBhwdlhbNz7bUVhoNvNC8BqJIzNbfqXBvEqxTEto8BTrNvN0GvT90W5JZMkX_YN0MvXg8gNEV4NC8xNEV4N03eN0B5tZlqNxTEto8BTrNvNeZVuJ10Kj_g2UB02J0mN0B5tZlqNCNEto8BTrNvNC7MTX502C8f2jmMQJ6mqF2fka1mqx6gqj0eN0B599M=&uipk=5&nbs=1&deadline=1591596728&gen=playurl&os=ks3bv&oi=606633803&trid=76bea9a9e56f4cb89a9aff2f8213c9acu&platform=pc&upsig=6a8ae3711bd0bb2a484ec2427d659b14&uparams=e,uipk,nbs,deadline,gen,os,oi,trid,platform&mid=0&orderid=0,2&logo=80000000",
                "order": 1,
                "md5": ""
            }
        ],
        "seek_param": "start",
        "no_rexcode": 0,
        "format": "flv_p60",
        "fnval": 0,
        "video_project": true,
        "fnver": 0,
        "message": "",
        "type": "FLV",
        "accept_quality": [
            116,
            74,
            80,
            64,
            32,
            16
        ],
        "quality": 116,
        "timelength": 2222204,
        "result": "suee",
        "seek_type": "offset",
        "has_paid": false,
        "supportFormats": [
            {
                "format": "flv_p60",
                "description": "高清 1080P60",
                "quality": 116
            },
            {
                "format": "flv720_p60",
                "description": "高清 720P60",
                "quality": 74
            },
            {
                "format": "flv",
                "description": "高清 1080P",
                "quality": 80
            },
            {
                "format": "flv720",
                "description": "高清 720P",
                "quality": 64
            },
            {
                "format": "flv480",
                "description": "清晰 480P",
                "quality": 32
            },
            {
                "format": "flv360",
                "description": "流畅 360P",
                "quality": 16
            }
        ],
        "from": "local",
        "video_codecid": 7,
        "accept_description": [
            "高清 1080P60",
            "高清 720P60",
            "高清 1080P",
            "高清 720P",
            "清晰 480P",
            "流畅 360P"
        ],
        "status": 0
    },
    "message": "success"
}

视频的获取

将data.durl.[1-n].url或data.durl.[1-n].backup_url.[0]中的内容作为url进行GET操作, 如果有多个视频, 需要手动合并处理

需要验证请求referer为 .bilibili.com域名下（防盗链），且user-agent 不为空

referer或user-agent错误的情况会返回403 Forbidden故无法获取

以上述视频url为例：

wget 'https://upos-sz-mirrorks3c.bilivideo.com/upgcxcode/93/59/132105993/132105993_da2-1-116.flv?e=ig8euxZM2rNcNbNghzTBhwdlhbNz7bUVhoNvNC8BqJIzNbfqXBvEqxTEto8BTrNvN0GvT90W5JZMkX_YN0MvXg8gNEV4NC8xNEV4N03eN0B5tZlqNxTEto8BTrNvNeZVuJ10Kj_g2UB02J0mN0B5tZlqNCNEto8BTrNvNC7MTX502C8f2jmMQJ6mqF2fka1mqx6gqj0eN0B599M=&uipk=5&nbs=1&deadline=1591596728&gen=playurl&os=ks3cbv&oi=606633803&trid=76bea9a9e56f4cb89a9aff2f8213c9acu&platform=pc&upsig=b271bf493bff32ffe62969582c8d18b4&uparams=e,uipk,nbs,deadline,gen,os,oi,trid,platform&mid=0&orderid=1,2&logo=40000000'\
-e 'https://www.bilibili.com'\
-O 'Download_video.flv'

响应正文将返回一个flv文件