本项目是基于Go语言编写的哔哩哔哩API调用。目前常用的接口已经基本完成。
本项目不会编写单元测试代码。一则因为各项数据会频繁变动，难以写成固定的结果；二则因为每次单元测试都要大量请求B站API，会对其产生不必要的压力。 如果你发现有接口bug或者有你需要但是本库尚未实现的接口，可以提交issue或者提交pull request。 如果因为B站修改了接口导致接口突然不可用，不一定能够及时更新，很大程度上需要依赖各位的告知。
Important
现在是v2版本，v2版本需要Go1.19及以上。如果还想使用v1版本可以点击这里跳转。
如果你觉得本项目对你有帮助，点亮右上角的↗ ⭐ 不迷路
- 本项目遵守 AGPL 开源协议。
- 本项目基于 SocialSisterYi/bilibili-API-collect 中描述的接口编写。请尊重该项目作者的努力，遵循该项目的开源要求，禁止一切商业使用。
- 请勿滥用，本项目仅用于学习和测试！利用本项目提供的接口、文档等造成不良影响及后果与本人无关。
- 由于本项目的特殊性，可能随时停止开发或删档
- 本项目为开源项目，不接受任何形式的催单和索取行为，更不容许存在付费内容
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值方便下次启动程序时不需要重新登录。
// 获取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"分隔多个cookieSetRawCookies使用的字符串是"cookie1=xxx; cookie2=xxx"，只包含key=value，以"; "分隔多个cookie，这和在浏览器F12里复制的一样
请注意不要混用。
你可以很方便的调用其它接口，以下举个例子：
videoInfo, err := client.GetVideoInfo(bilibili.VideoParam{
Aid: 12345678,
})参数中非必填字段你可以不填（可以通过是否有omitempty来判断这个字段是否为非必填字段）。
方法都是按照对应功能的英文翻译命名的，因此你可以方便地使用IDE找到想要的方法，配合注释便能够知道如何使用。
因为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()调用client.Resty()就可以获取到*resty.Client，然后自行操作即可。但是不要做一些离谱的操作（比如把Cookies删了）
client.Resty().SetTimeout(20 * time.Second) // 设置超时时间
client.Resty().SetLogger(logger) // 自定义logger不知道在哪些方面可以做贡献？点击这里看看吧！
命名规范和编码风格请参考CONTRIBUTING.md