01 / CAPABILITIES
开放功能
核心接口调用手册
2 个场景两份核心手册、四个只读资源接口:授权账号资料与 scope 核查,以及授权用户稿件列表与投稿分区。每个接口均给出完整 Node.js 22 公共签名 2.0 示例,接入准备说明官方 OAuth 流程;不覆盖视频上传、发布、删除或独立直播项目协议。
OAuth 授权与用户账号绑定
通过官方 PC 或移动 H5 授权页取得 code,由服务端交换 access_token 与 refresh_token,让 UP 主在不交出账号密码的前提下授权应用。
接入要求先完成开发者入驻、应用申请及所需 scope 审核;配置与实际回调一致的应用回调域,校验 state。应用新增权限后,原授权用户需重新勾选对应 scope。
授权账号资料与权限核查
读取当前授权用户的昵称、头像地址和应用维度 openid,并查询该用户实际勾选过的 scope 列表,用于绑定账号与控制功能入口。
接入要求USER_INFO 需应用申请通过且用户同意;GET 资源请求使用 access-token 与公共签名 2.0。头像按官方要求缓存使用,openid 不用于跨应用追踪。
读取授权账号资料与权限站内调用手册 · 参数、代码与排错→授权用户稿件列表与投稿分区
分页查询授权 UP 主的稿件、发布状态与审核原因;读取当前分区树,为投稿表单选择二级分区 tid。可用于创作工作台的稿件同步和状态排查。
接入要求ARC_BASE 需应用权限获批且用户授权;稿件列表 pn 从 1 开始,ps 为 1–50;只能使用授权范围内的数据。列表查询与分区读取不会自动发布稿件。
查询授权用户稿件与投稿分区站内调用手册 · 参数、代码与排错→02 / REQUIREMENTS
接入条件
- 适用主体
- 内容管理系统开发者、企业创作工具团队、经授权的 UP 主服务商
- 接入方式
- OAuth 2.0:用户在 B站官方授权页同意,服务端用 code 换取 access_token;新增 scope 后需重新引导用户勾选授权。 / 本页资源接口同时要求 access-token 与公共签名 2.0:client_id、app_secret、HMAC-SHA256、空请求体 MD5、秒级时间戳及唯一 nonce。 / 直播创作者服务中心的项目凭证与协议另行申请;不使用 WBI、浏览器 Cookie 或逆向接口替代开放平台授权。
- 申请概况
- 当前入驻指引暂未开放个人开发者申请;需企业资质、公函及应用认证,相关 scope 获批后还要用户逐项授权。
- 当前官方开发者入驻指引明确暂未开通个人开发者申请。企业需提交营业执照扫描件、按模板填写并加盖单位公章或财务专用章的申请公函;注册人需手签或电子签,公函有效期在一年内。
- 企业名称、单位地址与经营范围应与营业执照一致;营业执照和公函按要求提供彩色扫描件,黑白扫描件需补彩色公章。不能用已有普通B站账号推定开发者认证已完成。
- 在管理中心完成身份认证后创建应用,详细说明接入用途和应用场景;官方指引要求应用地址对应 ICP 备案主体与入驻主体一致。通过主体认证仍不等于应用认证和所有接口权限已开通。
- 为应用申请最小必要权限:本页账号与 scope 查询需要 USER_INFO,稿件及分区查询需要 ARC_BASE;之后引导目标 UP 主在官方授权页同意。新增 scope 后需用户重新授权。
- 配置自己的授权回调域;PC 授权使用 account.bilibili.com 的当前授权页,对 gourl 做 URL 编码,保存并验证随机 state,再由服务端以 code、client_id、client_secret 和 grant_type 交换令牌。
- client_id、app_secret 与用户 access_token 必须来自同一应用授权关系。资源接口计算全部 x-bili- 请求头的签名;保持服务器时钟同步,每次请求生成新 nonce。
- 按返回的过期时间管理令牌,提前续期并原子保存新的 access_token 和 refresh_token;官方说明 refresh_token 只能使用一次。用户撤销授权或账号注销后应处理解除授权事件。
03 / GET STARTED
开通步骤
- 01
核对企业主体与备案
先核对营业执照、公函和应用 ICP 备案主体,再向开放平台提交身份认证。
- 02
创建应用并申请接口权限
说明真实场景,申请 USER_INFO、ARC_BASE 等实际需要的 scope,等待主体、应用及接口权限审核。
- 03
完成官方用户授权
配置回调域、构造当前 PC/H5 授权链接,用户同意后校验 state,服务端交换并安全保存令牌。
- 04
签名调用并处理授权变化
使用站内完整代码读取账号和稿件,核对 HTTP 状态与业务 code,并处理令牌过期、撤销授权和限流。
04 / COSTS & LIMITS
费用、边界与测试方式
费用概况官方公开资料未给出本组查询接口的统一价目表,费用与权限开通应分别确认。
- 本页 USER_INFO、授权范围、稿件列表及分区查询的官方接口文档未列每次请求单价或可承诺的免费次数;没有价目不能写成永久免费或无限调用。
- 开发者服务协议第四部分约定平台可收取服务费用,实际收费标准与结算方式以平台公布为准。主体认证、应用开通与具体合作是否涉及费用,接入前向平台或管理中心核实。
- 官方状态码包含接口次数达到上限、频率过高及白名单限制;未公开本组接口统一 QPS 或日额度,需按获批应用的实际限额设计缓存和退避。
- 自己的服务器、回调服务与头像缓存存储等成本由接入方承担;直播互动、交易电商或其他业务的收费不能由本页查询接口推断。
使用范围与限制
- 本条目写明企业开发者入驻条件;开发者服务协议虽列出自然人、法人或其他组织,具体申请能否开放仍以当前入驻指引和控制台为准,不承诺个人可直接申请。
- 接口必须同时满足应用权限与用户授权;不能凭公开 UID、视频地址、浏览器 Cookie 或第三方 WBI 签名抓取任意账号的数据。
- 开放平台文档列有视频投递、编辑、删除等其他能力,本页手册仅演示账号、scope、稿件列表和分区的只读接口,不把上传与审核发布流程简化为一次 GET。
- open-live.bilibili.com 直播创作者服务中心是另一套接入体系;本页公共签名 2.0 代码不适用于该平台的项目启停与直播互动请求。
- 响应 code=0 才表示本次接口成功;读取到稿件仍需核对 addit_info.state,0 才是开放浏览,未开放稿件的 video_info 可能为空。
- 仅在用户同意及平台约定目的和期限内处理开放数据;本文不提供全站采集、视频下载或绕过审核的能力。
如何进行开发测试
- 本页资源接口使用 https://member.bilibili.com/arcopen/fn/,OAuth 令牌接口为官方文档列出的 https://api.bilibili.com/x/account-oauth2/v1/token;该地址不同于第三方逆向 WBI 接口。
- 网页授权页在 2025 年 3 月更新为 account.bilibili.com 的 PC/H5 页面;旧 passport.bilibili.com/register/pc_oauth2.html 停止维护,本文不使用旧入口。
- 本次未登录开发者账号、申请权限或发起真实 API;不把官方 SDK 中自行切换 UAT 的参数当作已向所有开发者开放的公共沙箱。
接入前再确认
- 通过官方站浏览器实时读取入驻、网页授权、账号授权、公共签名、用户信息、授权 scope、稿件列表、分区和服务协议正文;未进入登录或创建应用。
- 官方 C# 示例交叉核对 UTF-8 MD5、x-bili- 头排序、末尾不加换行与 HMAC-SHA256;本站 Node.js 示例为按协议编写的完整实现。
- 直播入口只核对为独立官方平台,不把其项目资格、费率或接口参数标成已完整核验。
05 / OFFICIAL SOURCES
官方资料
以下资料用于核对本页内容。申请与使用时,请以对应接口的最新规则为准。
- 01
- 02
- 03
- 04
- 05
- 06
- 07
- 08
- 09
- 10
- 11
- 12
- 13
官方文档及官方 SDK 核对,未进行接口实测
最近核验 2026-10-15 · 查看核验说明