登录
首页 >  文章 >  php教程

PHP调用B站API获取用户视频列表方法

时间:2026-05-06 12:12:35 418浏览 收藏

本文深入解析了PHP调用B站开放平台API获取用户视频列表的核心难点与实战要点:重点强调access_token必须严格置于Authorization请求头(Bearer格式),而非URL或请求体中,否则必返401;同时提醒token仅2小时有效、需配合refresh_token刷新,以及WBI签名在搜索类接口中的强制性与实现复杂度;此外还纠正了视频发布时间因时区未设为Asia/Shanghai导致的8小时偏差问题,并明确指出绕过过时SDK、直接使用curl手动构造请求才是当前最稳定可靠的方案。

php怎么调用bilibili开放平台_php如何获取B站用户视频列表

curl 请求 B 站 OpenAPI 时返回 401 或 “invalid access_token”

根本原因不是 token 没传,而是 access_token 必须放在请求头(Authorization: Bearer {token}),不能塞在 URL 参数或 POST body 里——B 站 OpenAPI 严格校验这个位置。

  • 错误写法:https://api.bilibili.com/x/v2/space/video?access_token=xxx&mid=123 → 会被无视
  • 正确写法:用 curl_setopt($ch, CURLOPT_HTTPHEADER, ['Authorization: Bearer xxx'])
  • 注意:access_token 是短期有效的(默认 2 小时),过期后必须用 refresh_token 换新,不能硬编码或缓存太久
  • 如果用 file_get_contents(),它不支持自定义 header,必须切到 curl

调用 x/v2/space/video 接口拿用户投稿列表的最小可行 PHP 示例

别碰 SDK,B 站官方没维护 PHP SDK,第三方库大多过期或漏签名逻辑。直接 curl 最稳。

  • 必须带 mid(目标用户的 UID),不是昵称或 UID 字符串,是纯数字(如 202324
  • 分页靠 pn(页码)和 ps(每页数量),最大 ps=30,超过会截断
  • 响应是 JSON,用 json_decode($res, true) 解析,检查 ['code'] === 0 再取 ['data']['list']['vlist']
  • 示例片段:
    $ch = curl_init();
    curl_setopt($ch, CURLOPT_URL, 'https://api.bilibili.com/x/v2/space/video?mid=202324&pn=1&ps=20');
    curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
    curl_setopt($ch, CURLOPT_HTTPHEADER, ['Authorization: Bearer ' . $access_token]);
    $res = curl_exec($ch);
    curl_close($ch);
    $data = json_decode($res, true);
    if ($data['code'] === 0) {
        foreach ($data['data']['list']['vlist'] as $v) {
            echo $v['title'] . "\n";
        }
    }
    

PHP 中处理 B 站返回的视频发布时间(created 字段)

created 是 Unix 时间戳(秒级),但 PHP 的 date() 默认按本地时区解析,而 B 站所有时间都基于东八区(UTC+8)——不显式设时区,时间会差 8 小时。

  • 别用 date('Y-m-d', $v['created']) 直接格式化
  • 先设时区:date_default_timezone_set('Asia/Shanghai'),再 date()
  • 或者更稳妥:用 DateTime 显式指定时区:(new DateTime())->setTimestamp($v['created'])->setTimezone(new DateTimeZone('Asia/Shanghai'))
  • 注意:B 站接口不返回 ISO 格式时间字符串,别指望自动识别时区

为什么用 file_get_contents()x/space/wbi/arc/search 会失败

这个接口强制要求 WBI 签名(即 URL 中的 wtsw_rid 参数),而签名依赖动态生成的 img_keysub_key,它们得先从 https://api.bilibili.com/x/web-interface/nav/x/web-interface/wbi/img 拿到——file_get_contents() 无法做两步请求 + 拼参数。

  • WBI 签名不是简单哈希,要拼接字符串、base64、md5,还涉及固定 salt,PHP 里得手写逻辑(B 站没公开完整规则,得逆向 JS)
  • 目前稳定可用的 PHP 实现集中在 GitHub 上几个活跃仓库(搜 “bilibili-wbi-php”),但要注意它们是否更新了 2024 年的新 salt
  • 如果你只是查自己账号的视频,绕开 WBI:用 x/v2/space/video(需登录态);想搜别人公开视频,才必须上 WBI
实际跑通的关键,是把 token 生命周期、WBI 签名必要性、时区这三件事拎清楚——其他都是 curl 配置细节。

好了,本文到此结束,带大家了解了《PHP调用B站API获取用户视频列表方法》,希望本文对你有所帮助!关注golang学习网公众号,给大家分享更多文章知识!

资料下载
相关阅读
更多>
最新阅读
更多>
课程推荐
更多>