README

您所在的位置：网站首页 › 哔哩哔哩错误接口 › README

README

2024-07-10 12:11| 来源: 网络整理| 查看: 265

Bilibili API 第三方文档API 分类注意事项关于滥用禁止登录关于封禁请求地址请求方法关于编码关于 UserAgent通用调用参数通用错误代码签名(sign)生成方式代码示例来源(书栈小编注)Bilibili API 第三方文档

绝大部分内容根据 http://docs.bilibili.cn/wiki 官方文档进行编写

哔哩哔哩开放平台为第三方提供了简便的合作模式，满足了网站、手机和平板电脑用户随时随地观看哔哩哔哩的需求。哔哩哔哩开放平台提供相关接口，以实现第三方WAP站和客户端等多种应用的接入。

API 分类

作者推荐；番剧；弹幕；动态；

视频/专题收藏、关注；视频评论；好友/悄悄关注/黑名单；

历史记录；批量获取排行信息(首页)；获取视频排行信息；

登录行为记录；第三方登录；登录；

我的信息；通知；视频推荐；搜索；读取/创建专题；

番剧专题；搜索关键词；标签；用户信息；获取视频信息。

注意事项关于滥用

以下这些，但并不限于以下这些行为都被视为滥用：a.短时间内大量操作API用于采集。b.测试帐号及密码c.其它没有提到的，但会给系统带来压力的请求行为。

禁止登录

如果账号尝试登录错误次数在 30 分钟内超过 5 次则会被禁止登录一个小时，写程序的时候特别是客户端的时候必须判断是否登录成功，如果不成功必须马上停止尝试。

关于封禁

由于滥用 API 将会导致 API 被封禁，但并不影响在官方网站上的使用，封禁一定的时间后会自动解除，一般需要一个小时后才会解封，所以请小心操作，不要拿 API 进行大量测试

请求地址

请求的地址为 http://api.bilibili.com/ 开头的地址

请求方法

只支持 GET 方法请求数据，用其它方法会提示相关错误。

关于编码

请用 UTF-8 编码进行数据传输，返回的数据也是 UTF-8 编码的。

关于 UserAgent

请求的时候必须设置 UserAgent，如果不设置或者设置为不合法的（比如设置为浏览器的）也会导致账号被封禁 API。 UserAgent 的格式必须为：程序英文名称/版本 (联系邮箱) 比如：BiLiBiLi WP Client/1.0.0 ([email protected])

通用调用参数字段必选类型说明 type false string (json/xml/jsonp) 返回数据方式默认json appkey true string 应用appkey ts true int 当前时间截 (UNIX TIMESTAMP) sign true string 应用校验密匙 callback false string JSONp调用方式时回调函数名称 access_key false string 应用在用户申请登陆后获取到的access_key 可以此access_key访问需要用户权限的操作 platform false string (android/ios) 客户端平台适配及统计用通用错误代码代码说明 -1 应用程序不存在或已被封禁 -2 Access key错误 -3 API校验密匙错误 -101 帐号未登陆 -102 帐号被封停 -103 积分不足 -104 硬币不足 -105 验证码错误 -106 帐号未激活 -107 帐号非正式会员或在适应期 -108 应用沒有存取相应功能的权限 -400 请求有误 -403 权限不足 -404 文档不存在 -500 服务器内部错误 -503 调用速度过快签名(sign)生成方式

把接口所需所有参数拼接，如utk=xx&time=xx，按参数名称排序，最后再拼接上密钥App-Secret，做md5加密 (callback不需要参与sign校检)

代码示例

PHP 版本:

/** * @param $params array 参数列表 * @param $key 加密密钥 * @return array sign:加密校验串,params:参数拼接串 */ function get_sign($params, $key) { $_data = array(); ksort($params); reset($params); foreach ($params as $k => $v) { // rawurlencode 返回的转义数字必须为大写( 如%2F ) $_data[] = $k . '=' . rawurlencode($v); } $_sign = implode('&', $_data); return array( 'sign' => strtolower(md5($_sign . $key)), 'params' => $_sign, ); } define("APP_SECRET","abcdef123456"); get_sign(array("type"=>"json"),APP_SECRET);

JS 版本:

/script> function get_sign(params, key) { var s_keys = []; for (var i in params) { s_keys.push(i); } s_keys.sort(); var data = ""; for (var i = 0; i < s_keys.length; i++) { // encodeURIComponent 返回的转义数字必须为大写( 如 %2F ) data+=(data ? "&" : "")+s_keys[i]+"="+encodeURIComponent(params[s_keys[i]]); } return { "sign":hex_md5(data+key), "params":data }; }来源(书栈小编注)

https://github.com/fython/BilibiliAPIDocs

【本文地址】

README

README

今日新闻

推荐新闻