本项目是基于Go语言编写的哔哩哔哩API调用。目前常用的接口已经基本完成。

本项目不会编写单元测试代码。一则因为各项数据会频繁变动，难以写成固定的结果；二则因为每次单元测试都要大量请求B站API，会对其产生不必要的压力。 如果你发现有接口bug或者有你需要但是本库尚未实现的接口，可以提交issue或者提交pull request。 如果因为B站修改了接口导致接口突然不可用，不一定能够及时更新，很大程度上需要依赖各位的告知。

[!IMPORTANT] 现在是v2版本，v2版本需要Go1.19及以上。如果还想使用v1版本可以点击这里跳转。

如果你觉得本项目对你有帮助，点亮右上角的↗ :star: 不迷路

声明

1. 本项目遵守 AGPL 开源协议。
2. 本项目基于 SocialSisterYi/bilibili-API-collect 中描述的接口编写。请尊重该项目作者的努力，遵循该项目的开源要求，禁止一切商业使用。
3. 请勿滥用，本项目仅用于学习和测试！利用本项目提供的接口、文档等造成不良影响及后果与本人无关。
4. 由于本项目的特殊性，可能随时停止开发或删档
5. 本项目为开源项目，不接受任何形式的催单和索取行为，更不容许存在付费内容

PS：目前，B站调用接口时强制使用 https 协议

快速开始

安装

go get -u github.com/CuteReimu/bilibili/v2

在项目中引用即可使用

import "github.com/CuteReimu/bilibili/v2"

var client = bilibili.New()

首次登录

[!TIP] 下文为了篇幅更短，示例中把很多显而易见的err校验忽略成了_，实际使用请自行校验err。

方法一：扫码登录

首先获取二维码：

qrCode, _ := client.GetQRCode()
buf, _ := qrCode.Encode()
img, _ := png.Decode(buf) // 或者写入文件 os.WriteFile("qrcode.png", buf, 0644)
// 也可以调用 qrCode.Print() 将二维码打印在控制台

扫码并确认成功后，发送登录请求：

result, err := client.LoginWithQRCode(bilibili.LoginWithQRCodeParam{
    QrcodeKey: qrCode.QrcodeKey,
})
if err == nil && result.Code == 0 {
    log.Println("登录成功")
}

方法二：账号密码登录

首先获取人机验证参数：

captchaResult, _ := client.Captcha()

将captchaResult中的gt和challenge值保存下来，自行使用 手动验证器 进行人机验证，并获得validate和seccode。然后使用账号密码进行登录即可：

result, err := client.LoginWithPassword(bilibili.LoginWithPasswordParam{
    Username:  userName,
    Password:  password,
    Token:     captchaResult.Token,
    Challenge: captchaResult.Geetest.Challenge,
    Validate:  validate,
    Seccode:   seccode,
})
if err == nil && result.Status == 0 {
    log.Println("登录成功")
}

方法三：使用短信验证码登录（不推荐）

首先用上述方法二相同的方式获取人机验证参数并进行人机验证。然后获取国际地区代码：

countryCrownResult, _ := client.GetCountryCrown()

当然，如果你已经确定cid的值，这一步可以跳过。中国大陆的cid就是86。

然后发送短信验证码：（这个接口大概率返回86103错误）

sendSMSResult, _ := client.SendSMS(bilibili.SendSMSParam{
    Cid:       cid,
    Tel:       tel,
    Source:    "main_web",
    Token:     captchaResult.Token,
    Challenge: captchaResult.Geetest.Challenge,
    Validate:  validate,
    Seccode:   seccode,
})

然后就可以使用手机验证码登录了：

result, err := client.LoginWithSMS(bilibili.LoginWithSMSParam{
    Cid:        cid,
    Tel:        tel,
    Code:       123456, // 短信验证码
    Source:     "main_web",
    CaptchaKey: sendSMSResult.CaptchaKey,
})
if err == nil && result.Status == 0 {
    log.Println("登录成功")
}

储存Cookies

使用上述任意方式登录成功后，Cookies值就已经设置好了。你可以保存Cookies值方便下次启动程序时不需要重新登录。

// 获取cookiesString，自行存储，方便下次启动程序时不需要重新登录
cookiesString := client.GetCookiesString()

// 下次启动时，把存储的cookiesString设置进来，就不需要登录操作了
client.SetCookiesString(cookiesString)

// 如果你是从浏览器request的header中直接复制出来的cookies，则改为调用SetRawCookies
client.SetRawCookies("cookie1=xxx; cookie2=xxx")

[!NOTE]

• GetCookiesString和SetCookiesString使用的字符串是"cookie1=xxx; expires=xxx; domain=xxx.com; path=/\ncookie2=xxx; expires=xxx; domain=xxx.com; path=/"，包含过期时间、domain等一些其它信息，以"\n"分隔多个cookie
• SetRawCookies使用的字符串是"cookie1=xxx; cookie2=xxx"，只包含key=value，以"; "分隔多个cookie，这和在浏览器F12里复制的一样

请注意不要混用。

其它接口

你可以很方便的调用其它接口，以下举个例子：

videoInfo, err := client.GetVideoInfo(bilibili.VideoParam{
    Aid: 12345678,
})

参数中非必填字段你可以不填（可以通过是否有omitempty来判断这个字段是否为非必填字段）。

方法都是按照对应功能的英文翻译命名的，因此你可以方便地使用IDE找到想要的方法，配合注释便能够知道如何使用。

对B站返回的错误码进行处理

因为B站的返回内容是这样的格式：

{
   "code": 0,
   "message": "错误信息",
   "data": {}
}

而我们这个库的接口只会返回data数据和一个error，若code为0则error为nil，否则我们并不会把code和message字段直接返回。

在一般情况下，调用者不太需要关心code和message字段，只需要关心是否有error即可。 但如果你实在需要code和message字段，我们也提供了一个办法：

videoInfo, err := client.GetVideoInfo(bilibili.VideoParam{
    Aid: 12345678,
})
if err != nil {
    var e bilibili.Error
    if errors.As(err, &e) { // B站返回的错误
        log.Printf("错误码: %d, 错误信息: %s", e.Code, e.Message)
    } else { // 其它错误
        log.Printf("%+v", err)
    }
}

[!TIP] 我们的所有error都包含堆栈信息。如有需要，你可以用log.Printf("%+v", err)打印出堆栈信息，方便追踪错误。

可能用到的工具接口

// 解析短连接
typ, id, err := client.UnwrapShortUrl("https://b23.tv/xxxxxx")

// 获取服务器当前时间
now, err := client.Now()

// av号转bv号
bvid := bilibili.AvToBv(111298867365120)

// bv号转av号
aid := bilibili.BvToAv("BV1L9Uoa9EUx")

// 通过ip确定地理位置
zoneLocation, err := client.GetZoneLocation()

// 获取分区当日投稿稿件数
regionDailyCount, err := client.GetRegionDailyCount()

设置*resty.Client的一些参数

调用client.Resty()就可以获取到*resty.Client，然后自行操作即可。但是不要做一些离谱的操作（比如把Cookies删了）

client.Resty().SetTimeout(20 * time.Second) // 设置超时时间
client.Resty().SetLogger(logger) // 自定义logger

Star History

如何为仓库做贡献？

不知道在哪些方面可以做贡献？点击这里看看吧！

命名规范和编码风格请参考CONTRIBUTING.md