diff --git a/.gitignore b/.gitignore new file mode 100644 index 0000000..53cc344 --- /dev/null +++ b/.gitignore @@ -0,0 +1,6 @@ + +login/QR.md +user/relation.md +user/space.md +user/status num.md +login/password&SMS.md diff --git a/README.md b/README.md new file mode 100644 index 0000000..16410c5 --- /dev/null +++ b/README.md @@ -0,0 +1,26 @@ +#哔哩哔哩-API收集整理 +------- + +本项目对B站的野生api进行收集整理，以及研究使用方法并对其进行说明 +所有api均为标准http协议，返回值均为json + +**不断更新中....** + +计划整理分类： +- 文章 +- 音频 +- 番剧 +- 小黑屋 +- 评论区 +- 创作中心 +- 弹幕 +- 动态 +- 历史&稍后再看 +- 直播 +- 登录 +- 用户 +- 视频 + +**注意：请勿滥用，仅用于学习和测试！** +**注意：请勿滥用，仅用于学习和测试！** +**注意：请勿滥用，仅用于学习和测试！** diff --git a/user/info.md b/user/info.md new file mode 100644 index 0000000..d068d11 --- /dev/null +++ b/user/info.md @@ -0,0 +1,454 @@ +#用户详细信息 +---------- +##用户详细信息1 (用于空间) +api.bilibili.com/x/space/acc/info +*方式:GET* + +参数： +| 参数名 | 内容 | 必要性 | 备注 | +| -------| ------- | ------ |------| +| mid | 用户UID | 必要 | | + + +**json回复：** +| 字段 | 类型 | 内容 | 备注 | +| ------- | ----- | --------- | ------------------ | +| code | num | 返回值 | 0成功 -400请求错误 | +| message | str | 错误信息 | 默认为0 | +| ttl | num | 1 | 作用尚不明确 | +| data | obj | 信息本体 | | + +data 对象： +| 字段 | 类型 | 内容 | 备注 | +| ----------- | ----- | -------------------- | ------------------------------- | +| mid | num | UID | | +| name | str | 昵称 | | +| sex | str | 性别 | 男 女 保密 | +| face | str | 头像链接 | jpg或gif | +| sign | str | 签名 | | +| rank | num | 10000 | 作用尚不明确 | +| level | num | 当前等级 | 0-6级 | +| jointime | num | 0 | 作用尚不明确 | +| moral | num | 0 | 作用尚不明确 | +| silence | num | 封禁状态 | 0正常 1被封 | +| birthday | str | 生日 | mm-dd | +| coins | num | 硬币数 | 需要登录 只能查看自己的 默认为0 | +| fans_badge | bool | 是否具有粉丝勋章 | | +| official | obj | 认证信息 | | +| vip | obj | 大会员状态 | | +| is_followed | bool | 是否关注此用户 | 需要登录 默认为false | +| top_photo | str | 主页头图链接 | png | +| theme | obj | 空 | 作用尚不明确 | +| sys_notice | obj | 空 | 作用尚不明确 | + +official 对象： +| 字段 | 类型 | 内容 | 备注 | +| ----- | ----- | -------- | ------------------------------- | +| role | num | 认证类型 | 0无 1 2个人认证 3 4 5 6机构认证 | +| title | str | 认证信息 | 默认为空 | +| desc | str | 空 | 作用尚不明确 | +| type | num | 是否认证 | -1无 0认证 | + +vip 对象： +| 字段 | 类型 | 内容 | 备注 | +| ---------- | ----- | ---------- | ------------------ | +| type | num | 大会员类型 | 0无 1月会员 2年会员| +| status | num | 大会员状态 | 0无 1有 | +| theme_type | num | 0 | 作用尚不明确 | + +示列： +http://api.bilibili.com/x/space/acc/info?mid=2 +``` +{ + "code": 0, + "message": "0", + "ttl": 1, + "data": { + "mid": 2, + "name": "碧诗", + "sex": "男", + "face": "http://i1.hdslb.com/bfs/face/3e60b20604b6fdc7d081eb6a1ec72aa47c5a3964.jpg", + "sign": "kami.im 直男过气网红 # av362830 “We Are Star Dust”", + "rank": 20000, + "level": 6, + "jointime": 0, + "moral": 0, + "silence": 0, + "birthday": "09-19", + "coins": 0, + "fans_badge": true, + "official": { + "role": 2, + "title": "bilibili创始人（站长）", + "desc": "", + "type": 0 + }, + "vip": { + "type": 2, + "status": 1, + "theme_type": 0 + }, + "is_followed": true, + "top_photo": "http://i2.hdslb.com/bfs/space/cb1c3ef50e22b6096fde67febe863494caefebad.png", + "theme": {}, + "sys_notice": {} + } +} +``` + +---------- +##用户详细信息2 (用于卡片) +api.bilibili.com/x/web-interface/card +*方式:GET* + +参数： +| 参数名 | 内容 | 必要性 | 备注 | +| -------| -------------------- | ------ |--------------- | +| mid | 用户UID | 必要 | | +| photo | 是否请求用户主页头图 | 非必要 | true是 false否 | + +**json回复：** +| 字段 | 类型 | 内容 | 备注 | +| ------- | ----- | --------- | ------------------ | +| code | num | 返回值 | 0成功 -400请求错误 | +| message | str | 错误信息 | 默认为0 | +| ttl | num | 1 | 作用尚不明确 | +| data | obj | 信息本体 | | + +data 对象： +| 字段 | 类型 | 内容 | 备注 | +| ---- | ----- | -------- | ---- | +| card | obj | 卡片信息 | | + +card 对象： +| 字段 | 类型 | 内容 | 备注 | +| --------------- | ----- | -------------------- | ------------------------------- | +| mid | num | 用户UID | | +| approve | bool | false | 作用尚不明确 | +| name | str | 用户昵称 | | +| sex | str | 用户性别 | 男 女 保密 | +| face | str | 用户头像链接 | jpg或gif | +| DisplayRank | str | 0 | 作用尚不明确 | +| regtime | num | 0 | 作用尚不明确 | +| spacesta | num | 0 | 作用尚不明确 | +| birthday | str | 空 | 作用尚不明确 | +| place | str | 空 | 作用尚不明确 | +| description | str | 空 | 作用尚不明确 | +| article | num | 0 | 作用尚不明确 | +| attentions | array | 空 | 作用尚不明确 | +| fans | num | 粉丝数 | | +| friend | num | 关注数 | | +| attention | num | 关注数 | | +| level_info | obj | 等级 | | +| pendant | obj | 挂件 | | +| nameplate | obj | 勋章 | | +| Official | obj | 认证信息 | | +| official_verify | obj | 认证信息 | | +| vip | obj | 大会员状态 | | +| space | obj | 主页头图 | | +| following | bool | 是否关注此用户 | 需要登录 默认为false | +| archive_count | num | 用户稿件数 | | +| article_count | num | 0 | 作用尚不明确 | +| follower | num | 粉丝数 | | + +level_info 对象： +| 字段 | 类型 | 内容 | 备注 | +| ------------- | ----- | ---------- | ------------------ | +| current_level | num | 当前等级 | 0-6级 | +| current_min | num | 0 | 作用尚不明确 | +| current_exp | num | 0 | 作用尚不明确 | +| next_exp | num | 0 | 作用尚不明确 | + +pendant 对象： +| 字段 | 类型 | 内容 | 备注 | +| ------------- | ----- | ---------------- | ------------------ | +| pid | num | 挂件id | | +| name | str | 挂件名称 | | +| image | str | 挂件图片链接 | png | +| expire | num | 0 | 作用尚不明确 | + +nameplate 对象： +| 字段 | 类型 | 内容 | 备注 | +| ------------- | ----- | ----------------- | ------------------ | +| nid | num | 勋章id | | +| name | str | 勋章名称 | | +| image | str | 挂件图片链接 正常 | png | +| image_small | str | 勋章图片链接 小 | png | +| level | str | 勋章等级 | | +| condition | str | 勋章条件 | | + +Official 对象： +| 字段 | 类型 | 内容 | 备注 | +| ----- | ----- | -------- | ------------------------------- | +| role | num | 认证类型 | 0无 1 2个人认证 3 4 5 6机构认证 | +| title | str | 认证信息 | 默认为空 | +| desc | str | 空 | 作用尚不明确 | +| type | num | 是否认证 | -1无 0认证 | + +official_verify 对象： +| 字段 | 类型 | 内容 | 备注 | +| ----- | ----- | -------- | ------------------------------- | +| type | num | 是否认证 | -1无 0认证 | +| desc | str | 认证信息 | | + +vip 对象： +| 字段 | 类型 | 内容 | 备注 | +| ------------- | ----- | ---------- | ------------------ | +| vipType | num | 大会员类型 | 0无 1月会员 2年会员| +| dueRemark | str | 空 | 作用尚不明确 | +| accessStatus | num | 0 | 作用尚不明确 | +| vipStatus | num | 大会员状态 | 0无 1有 | +| vipStatusWarn | str | 空 | 作用尚不明确 | +| theme_type | num | 0 | 作用尚不明确 | + +space 对象： +| 字段 | 类型 | 内容 | 备注 | +| --------- | ----- | ----------------- | ---------------- | +| s_img | str | 主页头图链接 小图 | png | +| l_img | str | 主页头图链接 正常 | png | + +示列： +http://api.bilibili.com/x/web-interface/card?mid=2&photo=true +``` +{ + "code": 0, + "message": "0", + "ttl": 1, + "data": { + "card": { + "mid": "2", + "name": "碧诗", + "approve": false, + "sex": "男", + "rank": "20000", + "face": "http://i1.hdslb.com/bfs/face/3e60b20604b6fdc7d081eb6a1ec72aa47c5a3964.jpg", + "DisplayRank": "0", + "regtime": 0, + "spacesta": 0, + "birthday": "", + "place": "", + "description": "", + "article": 0, + "attentions": [], + "fans": 810968, + "friend": 192, + "attention": 192, + "sign": "kami.im 直男过气网红 # av362830 “We Are Star Dust”", + "level_info": { + "current_level": 6, + "current_min": 0, + "current_exp": 0, + "next_exp": 0 + }, + "pendant": { + "pid": 76, + "name": "管理员", + "image": "http://i2.hdslb.com/bfs/face/02a3b79edef0f0e682de7f5dca7b6b5fe36d5f65.png", + "expire": 0 + }, + "nameplate": { + "nid": 10, + "name": "见习偶像", + "image": "http://i0.hdslb.com/bfs/face/e93dd9edfa7b9e18bf46fd8d71862327a2350923.png", + "image_small": "http://i1.hdslb.com/bfs/face/275b468b043ec246737ab8580a2075bee0b1263b.png", + "level": "普通勋章", + "condition": "所有自制视频总播放数\u003e=10万" + }, + "Official": { + "role": 2, + "title": "bilibili创始人（站长）", + "desc": "", + "type": 0 + }, + "official_verify": { + "type": 0, + "desc": "bilibili创始人（站长）" + }, + "vip": { + "vipType": 2, + "dueRemark": "", + "accessStatus": 0, + "vipStatus": 1, + "vipStatusWarn": "", + "theme_type": 0 + } + }, + "space": { + "s_img": "http://i2.hdslb.com/bfs/space/768cc4fd97618cf589d23c2711a1d1a729f42235.png", + "l_img": "http://i2.hdslb.com/bfs/space/cb1c3ef50e22b6096fde67febe863494caefebad.png" + }, + "following": true, + "archive_count": 35, + "article_count": 0, + "follower": 810968 + } +} +``` + +---------- +##自己详细信息 (需要登录) +api.bilibili.com/x/space/myinfo +*方式:GET* + +**json回复：** +| 字段 | 类型 | 内容 | 备注 | +| ------- | ----- | --------- | ------------------ | +| code | num | 返回值 | 0成功 -101未登录 | +| message | str | 错误信息 | 默认为0 | +| ttl | num | 1 | 作用尚不明确 | +| data | obj | 信息本体 | | + +data 对象： +| 字段 | 类型 | 内容 | 备注 | +| --------------- | ----- | -------------------- | ------------------------------- | +| mid | num | UID | | +| name | str | 昵称 | | +| sex | str | 性别 | 男 女 保密 | +| face | str | 头像链接 | jpg或gif | +| sign | str | 签名 | | +| rank | num | 10000 | 作用尚不明确 | +| level | num | 当前等级 | 0-6级 | +| jointime | num | 0 | 作用尚不明确 | +| moral | num | 节操 | 默认70 | +| silence | num | 封禁状态 | 0正常 1被封 | +| email_status | num | 已验证邮箱 | 0未验证 1已验证 | +| tel_status | num | 已验证手机号 | 0未验证 1已验证 | +| identification | num | 1 | 作用尚不明确 | +| vip | obj | 大会员状态 | | +| birthday | num | 生日 | 时间戳 | +| is_tourist | num | 0 | 作用尚不明确 | +| is_fake_account | num | 0 | 作用尚不明确 | +| pin_prompting | num | 0 | 作用尚不明确 | +| is_deleted | num | 0 | 作用尚不明确 | +| coins | num | 硬币数 | | +| following | num | 粉丝数 | | +| follower | num | 粉丝数 | | + +vip 对象： +| 字段 | 类型 | 内容 | 备注 | +| ------------ | ----- | -------------- | ------------------ | +| type | num | 大会员类型 | 0无 1月会员 2年会员| +| status | num | 大会员状态 | 0无 1有 | +| due_date | num | 大会员到期时间 | 毫秒 时间戳 | +| vip_pay_type | num | 1 | 作用尚不明确 | +| theme_type | num | 0 | 作用尚不明确 | +| label | obj | ？？？ | | + +label 对象: +| 字段 | 类型 | 内容 | 备注 | +| ------------ | ----- | ------ | ------------ | +| path | str | 空 | 作用尚不明确 | + +pendant 对象： +| 字段 | 类型 | 内容 | 备注 | +| ------------- | ----- | ---------------- | ------------------ | +| pid | num | 挂件id | | +| name | str | 挂件名称 | | +| image | str | 挂件图片链接 | png | +| expire | num | 0 | 作用尚不明确 | + +nameplate 对象： +| 字段 | 类型 | 内容 | 备注 | +| ------------- | ----- | ----------------- | ------------------ | +| nid | num | 勋章id | | +| name | str | 勋章名称 | | +| image | str | 挂件图片链接 正常 | png | +| image_small | str | 勋章图片链接 小 | png | +| level | str | 勋章等级 | | +| condition | str | 勋章条件 | | + +Official 对象： +| 字段 | 类型 | 内容 | 备注 | +| ----- | ----- | -------- | ------------------------------- | +| role | num | 认证类型 | 0无 1 2个人认证 3 4 5 6机构认证 | +| title | str | 认证信息 | 默认为空 | +| desc | str | 空 | 作用尚不明确 | +| type | num | 是否认证 | -1无 0认证 | + +level_exp 对象： +| 字段 | 类型 | 内容 | 备注 | +| ------------- | ----- | ---------- | ------------------ | +| current_level | num | 当前等级 | 0-6级 | +| current_min | num | 0 | 作用尚不明确 | +| current_exp | num | 0 | 作用尚不明确 | +| next_exp | num | 0 | 作用尚不明确 | + +| birthday | str | 生日 | mm-dd | +| coins | num | 硬币数 | 需要登录 只能查看自己的 默认为0 | +| fans_badge | bool | 是否具有粉丝勋章 | | +| official | obj | 认证信息 | | +| is_followed | bool | 是否关注此用户 | 需要登录 默认为false | +| top_photo | str | 主页头图链接 | png | +| theme | obj | 空 | 作用尚不明确 | +| sys_notice | obj | 空 | 作用尚不明确 | + +示例： +http://api.bilibili.com/x/space/myinfo +``` +{ + "code": 0, + "message": "0", + "ttl": 1, + "data": { + "mid": 293793435, + "name": "社会易姐QwQ", + "sex": "男", + "face": "http://i2.hdslb.com/bfs/face/480e2e98513aaeb65d2f2c76dbae750c4de722e9.jpg", + "sign": "咕咕咕咕咕", + "rank": 10000, + "level": 5, + "jointime": 0, + "moral": 70, + "silence": 0, + "email_status": 1, + "tel_status": 1, + "identification": 1, + "vip": { + "type": 2, + "status": 1, + "due_date": 1612454400000, + "vip_pay_type": 1, + "theme_type": 0, + "label": { + "path": "" + } + }, + "pendant": { + "pid": 294, + "name": "茶啊二中", + "image": "http://i0.hdslb.com/bfs/face/5bb7bef5107e448892ab54539298d50eb678de05.png", + "expire": 0 + }, + "nameplate": { + "nid": 0, + "name": "", + "image": "", + "image_small": "", + "level": "", + "condition": "" + }, + "official": { + "role": 0, + "title": "", + "desc": "", + "type": -1 + }, + "birthday": 1015257600, + "is_tourist": 0, + "is_fake_account": 0, + "pin_prompting": 0, + "is_deleted": 0, + "level_exp": { + "current_level": 5, + "current_min": 10800, + "current_exp": 13985, + "next_exp": 28800 + }, + "coins": 10.4, + "following": 358, + "follower": 358 + } +} +``` + +