Kingsmai/bilibili-API-collect
1
0
Fork 0
mirror of https://github.com/SocialSisterYi/bilibili-API-collect.git synced 2026-05-09 11:47:41 +08:00
Code Issues Packages Projects Releases Wiki Activity

fix format

Browse Source
This commit is contained in:
社会易姐QwQ
2022-03-24 16:42:36 +08:00
parent 9c0966fbf8
commit f609b482e3
3 changed files with 148 additions and 47 deletions
Download Patch File Download Diff File Expand all files Collapse all files

5
README.md
View File

@@ -191,7 +191,10 @@ PS：所有 rest api 均可使用 https，文档中为了统一写作`http`，
- [ ] 基本信息 - [ ] 基本信息
- [ ] B币充值 - [ ] B币充值
- [ ] 贝壳相关 - [ ] 贝壳相关
- [ ] 哔哩哔哩漫画 - [ ] [哔哩哔哩漫画](manga)
- [x] [签到](manga/clockin.md)
- [x] [积分商城](manga/point_shop.md)
- [ ] 哔哩哔哩游戏 - [ ] 哔哩哔哩游戏
- [ ] 轻视频 - [ ] 轻视频
- [ ] [终端网络查询](clientinfo) - [ ] [终端网络查询](clientinfo)

21
manga/ClockIn.md
View File

@@ -1,6 +1,6 @@
# 签到 # 签到
> https://manga.bilibili.com/twirp/activity.v1.Activity/ClockIn > http://manga.bilibili.com/twirp/activity.v1.Activity/ClockIn
*请求方式：POST* *请求方式：POST*
@@ -22,8 +22,22 @@
| msg | str | 错误信息 | 成功：空<br />已签到：clockin clockin is duplicate | | msg | str | 错误信息 | 成功：空<br />已签到：clockin clockin is duplicate |
| meta | obj | 错误信息 | 今日已签到时存在 | | meta | obj | 错误信息 | 今日已签到时存在 |
根对象：
| 字段 | 类型 | 内容 | 备注 |
| ---- | ---- | -------- | ---- |
| data | str | 错误信息 | |
**示例：**
```bash
curl 'http://manga.bilibili.com/twirp/activity.v1.Activity/ClockIn' \
-b 'SESSDATA=xxx'
```
<details> <details>
<summary>成功示例：</summary> <summary>签到成功：</summary>
```json ```json
{ {
@@ -36,7 +50,8 @@
</details> </details>
<details> <details>
<summary>今日已签到示例：</summary> <summary>今日已签到：</summary>
```json ```json
{ {

169
manga/Exchange.md → manga/point_shop.md
View File

@@ -1,10 +1,18 @@
# 积分商城 # 积分商城
- [获取当前持有点数](#获取当前持有点数)
- [获取兑换奖品列表](#获取兑换奖品列表)
- [兑换物品](#兑换物品)
- [获取兑换历史记录](#获取兑换历史记录)
- [获取玩法说明](#获取玩法说明)
*积分商城由web页面提供功能，地址为：* *积分商城由web页面提供功能，地址为：*
> https://manga.bilibili.com/eden/credits-exchange.html > https://manga.bilibili.com/eden/credits-exchange.html
# 获取当前持有点数 ## 获取当前持有点数
> https://manga.bilibili.com/twirp/pointshop.v1.Pointshop/GetUserPoint > http://manga.bilibili.com/twirp/pointshop.v1.Pointshop/GetUserPoint
*请求方式：POST* *请求方式：POST*
@@ -16,8 +24,8 @@
| 字段 | 类型 | 内容 | 备注 | | 字段 | 类型 | 内容 | 备注 |
| ------- | ---- | -------- | ------------------------------------------------------------ | | ------- | ---- | -------- | ------------------------------------------------------------ |
| code | num | 返回值 | 总是为0 | | code | num | 返回值 | |
| msg | str | 错误信息 | 为空 | | | msg | str | 错误信息 | |
| data | obj | 信息本体 | | | data | obj | 信息本体 | |
`data`对象： `data`对象：
@@ -26,8 +34,16 @@
| -------- | ---- | -------- | ------------ | | -------- | ---- | -------- | ------------ |
| point | str | 点数 | 不登录时为0 | | point | str | 点数 | 不登录时为0 |
**示例：**
```bash
curl 'http://manga.bilibili.com/twirp/pointshop.v1.Pointshop/GetUserPoint' \
-b 'SESSDATA=xxx'
```
<details> <details>
<summary>返回示例：</summary> <summary>查看响应示例：</summary>
```json ```json
{ {
@@ -41,14 +57,12 @@
</details> </details>
# 获取兑换奖品列表 ## 获取兑换奖品列表
> https://manga.bilibili.com/twirp/pointshop.v1.Pointshop/ListProduct > http://manga.bilibili.com/twirp/pointshop.v1.Pointshop/ListProduct
*请求方式：POST* *请求方式：POST*
认证方式：不登录可访问
**json回复：** **json回复：**
根对象： 根对象：
@@ -56,10 +70,18 @@
| 字段 | 类型 | 内容 | 备注 | | 字段 | 类型 | 内容 | 备注 |
| ------- | ---- | -------- | ------------------------------------------------------------ | | ------- | ---- | -------- | ------------------------------------------------------------ |
| code | num | 返回值 | | | code | num | 返回值 | |
| msg | str | 错误信息 | 为空 | | | msg | str | 错误信息 | |
| data | obj | 信息本体 | | | data | array | 奖品列表 | |
`data`对象： `data`数组：
| 项 | 类型 | 内容 | 备注 |
| ---- | ---- | --------- | ---- |
| 0 | obj | 奖品1 | |
| n | obj | 奖品(n+1) | |
| …… | obj | …… | …… |
`data`数组中的对象：
| 字段 | 类型 | 内容 | 备注 | | 字段 | 类型 | 内容 | 备注 |
| -------- | ---- | -------- | ------------ | | -------- | ---- | -------- | ------------ |
@@ -73,20 +95,27 @@
| remain_amount | num | 库存剩余数 | | | remain_amount | num | 库存剩余数 | |
| comic_id | num | 相关漫画id | | | comic_id | num | 相关漫画id | |
| limits | array | 限定使用范围（漫画） | 限免券所适用的漫画 | | limits | array | 限定使用范围（漫画） | 限免券所适用的漫画 |
| discount | num | 未知 | 目前恒为0 | | discount | num | (?) | 目前恒为0 |
| product_type | num | 物品类型 | 1：限免券、福利券<br />4：商城满99立减10元券、商城5元无门槛券<br />5：商城5魔晶 | | product_type | num | 物品类型 | 1：限免券、福利券<br />4：商城满99立减10元券、商城5元无门槛券<br />5：商城5魔晶 |
| pendant_url | str | 未知 | | | pendant_url | str | (?) | |
| pendant_expire | num | 未知 | 0：限免券、福利券<br />7：商城满99立减10元券、商城5元无门槛券、商城5魔晶 | | pendant_expire | num | (?) | 0：限免券、福利券<br />7：商城满99立减10元券、商城5元无门槛券、商城5魔晶 |
| exchange_limit | num | 兑换次数限制 | | | exchange_limit | num | 兑换次数限制 | |
| address_deadline | datetime | 未知 | | | address_deadline | str | (?) | |
| act_type | num | 未知 | 目前恒为0 | | act_type | num | (?) | 目前恒为0 |
| has_exchanged | bool | 是否兑换过该物品 | | | has_exchanged | bool | 是否兑换过该物品 | |
| main_coupon_deadline | datetime | 兑换后使用截止时间 | | | main_coupon_deadline | str | 兑换后使用截止时间 | |
| deadline | str | 兑换后使用截止时间 | | | deadline | str | 兑换后使用截止时间 | |
| point | str | 未知 | 目前恒为0 | | point | str | (?) | 目前恒为0 |
**示例：**
```bash
curl 'http://manga.bilibili.com/twirp/pointshop.v1.Pointshop/ListProduct'
```
<details> <details>
<summary>返回示例：</summary> <summary>查看响应示例：</summary>
```json ```json
{ {
@@ -220,17 +249,16 @@
</details> </details>
# 兑换物品
> https://manga.bilibili.com/twirp/pointshop.v1.Pointshop/Exchange ## 兑换物品
> http://manga.bilibili.com/twirp/pointshop.v1.Pointshop/Exchange
*请求方式：POST* *请求方式：POST*
认证方式：Cookie（SESSDATA）/ APP 认证方式：Cookie（SESSDATA）/ APP
**正文参数（ application/x-www-form-urlencoded ）：** **正文参数（ application/x-www-form-urlencoded 或 application/json）：**
以json方式请求也可以
| 参数名 | 类型 | 内容 | 必要性 | 备注 | | 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ---------- | ---- | ------------------------ | -------------- | ------------------------------------------------------------ | | ---------- | ---- | ------------------------ | -------------- | ------------------------------------------------------------ |
@@ -244,21 +272,40 @@
| 字段 | 类型 | 内容 | 备注 | | 字段 | 类型 | 内容 | 备注 |
| ------- | ---- | -------- | ------------------------------------------------------------ | | ------- | ---- | -------- | ------------------------------------------------------------ |
| code | num | 返回值 | 0：兑换成功<br /> 1：积分不足<br />2：库存不足<br />3：product point mismatch（point填写错误）<br />3：超过用户最大可兑换数量<br />4：现在抢票的人太多啦，再点一下有机会优先上车喔 ε=ε=(ノ≧∇≦)ノ| | code | num | 返回值 | 0：兑换成功<br />1：积分不足<br />2：库存不足<br />3：product point mismatch（point填写错误）<br />3：超过用户最大可兑换数量<br />4：现在抢票的人太多啦，再点一下有机会优先上车喔 ε=ε=(ノ≧∇≦)ノ |
| message | str | 错误信息 | | | | message | str | 错误信息 | |
| data | obj | 信息本体 |
# 获取兑换历史记录 **示例：**
> https://manga.bilibili.com/twirp/activity.v1.Activity/GetPrizeList ```bash
curl 'http://manga.bilibili.com/twirp/pointshop.v1.Pointshop/Exchange' \
--data-urlencode 'product_id=195' \
--data-urlencode 'product_num=1' \
--data-urlencode 'point=real_cost' \
-b 'SESSDATA=xxx'
```
<details>
<summary>查看响应示例：</summary>
```json
{
"code": 0,
"msg": ""
}
```
</details>
## 获取兑换历史记录
> http://manga.bilibili.com/twirp/activity.v1.Activity/GetPrizeList
*请求方式：POST* *请求方式：POST*
认证方式：Cookie（SESSDATA）/ APP 认证方式：Cookie（SESSDATA）/ APP
**正文参数（ application/x-www-form-urlencoded ）：** **正文参数（ application/x-www-form-urlencoded 或 application/json）：**
以json方式请求也可以
| 参数名 | 类型 | 内容 | 必要性 | 备注 | | 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ---------- | ---- | ------------------------ | -------------- | ------------------------------------------------------------ | | ---------- | ---- | ------------------------ | -------------- | ------------------------------------------------------------ |
@@ -274,18 +321,33 @@
| msg | str | 错误信息 | | | | msg | str | 错误信息 | | |
| data | obj | 信息本体 | | data | obj | 信息本体 |
`data`对象`prizes`节点： `data`对象：
| 字段 | 类型 | 内容 | 备注 |
| ------ | ---- | -------- | ---- |
| prizes | obj | 兑换记录 | |
| addr | obj | (?) | |
`data`中的`prizes`对象：
| 字段 | 类型 | 内容 | 备注 | | 字段 | 类型 | 内容 | 备注 |
| -------- | ---- | -------- | ------------ | | -------- | ---- | -------- | ------------ |
| user_prize_id | str | | | | user_prize_id | str | 兑换id? | |
| prize_id | num | 兑换的物品id | | | prize_id | num | 兑换的物品id | |
| ctime | datetime | 兑换时间 | | | ctime | str | 兑换时间 | |
| addr | | 未知 | | | addr | null | (?) | |
| deadline | datetime | 未知 | | | deadline | str | 过期时间 | |
| type | num | 未知 | 1：限免券、福利券<br />8：商城5魔晶 | | type | num | 类型 | 1：限免券、福利券<br />8：商城5魔晶 |
| name | str | 物品名 | | | name | str | 物品名 | |
**示例：**
```bash
curl 'http://manga.bilibili.com/twirp/activity.v1.Activity/GetPrizeList' \
--data-urlencode 'act_id=90018' \
-b 'SESSDATA=xxx'
```
<details> <details>
<summary>查看响应示例：</summary> <summary>查看响应示例：</summary>
@@ -344,16 +406,37 @@
</details> </details>
# 获取玩法说明 ## 获取玩法说明
> https://manga.bilibili.com/twirp/pointshop.v1.Pointshop/GetExchangeRule > http://manga.bilibili.com/twirp/pointshop.v1.Pointshop/GetExchangeRule
*请求方式：POST* *请求方式：POST*
认证方式：可不登录访问 **json回复：**
根对象：
| 字段 | 类型 | 内容 | 备注 |
| ---- | ---- | -------- | ---- |
| code | num | 返回值 | |
| msg | str | 错误信息 | |
| data | obj | 信息本体 | |
`data`对象：
| 字段 | 类型 | 内容 | 备注 |
| ---- | ---- | -------- | ---- |
| rule | str | 玩法说明 | |
**示例：**
```bash
curl 'http://manga.bilibili.com/twirp/pointshop.v1.Pointshop/GetExchangeRule'
```
<details> <details>
<summary>返回示例：</summary> <summary>查看响应示例：</summary>
```json ```json
{ {