diff --git a/README.md b/README.md index 53bbc2f..2ca9a08 100644 --- a/README.md +++ b/README.md @@ -191,7 +191,10 @@ PS：所有 rest api 均可使用 https，文档中为了统一写作`http`， - [ ] 基本信息 - [ ] B币充值 - [ ] 贝壳相关 -- [ ] 哔哩哔哩漫画 +- [ ] [哔哩哔哩漫画](manga) + - [x] [签到](manga/clockin.md) + - [x] [积分商城](manga/point_shop.md) + - [ ] 哔哩哔哩游戏 - [ ] 轻视频 - [ ] [终端网络查询](clientinfo) diff --git a/manga/ClockIn.md b/manga/ClockIn.md index b21e41f..34ca545 100644 --- a/manga/ClockIn.md +++ b/manga/ClockIn.md @@ -1,6 +1,6 @@ # 签到 -> https://manga.bilibili.com/twirp/activity.v1.Activity/ClockIn +> http://manga.bilibili.com/twirp/activity.v1.Activity/ClockIn *请求方式：POST* @@ -22,8 +22,22 @@ | msg | str | 错误信息 | 成功：空
已签到：clockin clockin is duplicate | | meta | obj | 错误信息 | 今日已签到时存在 | +根对象： + +| 字段 | 类型 | 内容 | 备注 | +| ---- | ---- | -------- | ---- | +| data | str | 错误信息 | | + +**示例：** + +```bash +curl 'http://manga.bilibili.com/twirp/activity.v1.Activity/ClockIn' \ +-b 'SESSDATA=xxx' +``` +
-成功示例： +签到成功： + ```json { @@ -36,7 +50,8 @@
-今日已签到示例： +今日已签到： + ```json { diff --git a/manga/Exchange.md b/manga/point_shop.md similarity index 71% rename from manga/Exchange.md rename to manga/point_shop.md index 494a5b6..8ed50cb 100644 --- a/manga/Exchange.md +++ b/manga/point_shop.md @@ -1,10 +1,18 @@ # 积分商城 + +- [获取当前持有点数](#获取当前持有点数) +- [获取兑换奖品列表](#获取兑换奖品列表) +- [兑换物品](#兑换物品) +- [获取兑换历史记录](#获取兑换历史记录) +- [获取玩法说明](#获取玩法说明) + *积分商城由web页面提供功能，地址为：* + > 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* @@ -16,8 +24,8 @@ | 字段 | 类型 | 内容 | 备注 | | ------- | ---- | -------- | ------------------------------------------------------------ | -| code | num | 返回值 | 总是为0 | -| msg | str | 错误信息 | 为空 | | +| code | num | 返回值 | | +| msg | str | 错误信息 | | | data | obj | 信息本体 | | `data`对象： @@ -26,8 +34,16 @@ | -------- | ---- | -------- | ------------ | | point | str | 点数 | 不登录时为0 | +**示例：** + +```bash +curl 'http://manga.bilibili.com/twirp/pointshop.v1.Pointshop/GetUserPoint' \ +-b 'SESSDATA=xxx' +``` +
-返回示例： +查看响应示例： + ```json { @@ -41,14 +57,12 @@
-# 获取兑换奖品列表 +## 获取兑换奖品列表 -> https://manga.bilibili.com/twirp/pointshop.v1.Pointshop/ListProduct +> http://manga.bilibili.com/twirp/pointshop.v1.Pointshop/ListProduct *请求方式：POST* -认证方式：不登录可访问 - **json回复：** 根对象： @@ -56,10 +70,18 @@ | 字段 | 类型 | 内容 | 备注 | | ------- | ---- | -------- | ------------------------------------------------------------ | | code | num | 返回值 | | -| msg | str | 错误信息 | 为空 | | -| data | obj | 信息本体 | | +| msg | str | 错误信息 | | +| data | array | 奖品列表 | | -`data`对象： +`data`数组： + +| 项 | 类型 | 内容 | 备注 | +| ---- | ---- | --------- | ---- | +| 0 | obj | 奖品1 | | +| n | obj | 奖品(n+1) | | +| …… | obj | …… | …… | + +`data`数组中的对象： | 字段 | 类型 | 内容 | 备注 | | -------- | ---- | -------- | ------------ | @@ -73,20 +95,27 @@ | remain_amount | num | 库存剩余数 | | | comic_id | num | 相关漫画id | | | limits | array | 限定使用范围（漫画） | 限免券所适用的漫画 | -| discount | num | 未知 | 目前恒为0 | +| discount | num | (?) | 目前恒为0 | | product_type | num | 物品类型 | 1：限免券、福利券
4：商城满99立减10元券、商城5元无门槛券
5：商城5魔晶 | -| pendant_url | str | 未知 | | -| pendant_expire | num | 未知 | 0：限免券、福利券
7：商城满99立减10元券、商城5元无门槛券、商城5魔晶 | +| pendant_url | str | (?) | | +| pendant_expire | num | (?) | 0：限免券、福利券
7：商城满99立减10元券、商城5元无门槛券、商城5魔晶 | | exchange_limit | num | 兑换次数限制 | | -| address_deadline | datetime | 未知 | | -| act_type | num | 未知 | 目前恒为0 | +| address_deadline | str | (?) | | +| act_type | num | (?) | 目前恒为0 | | has_exchanged | bool | 是否兑换过该物品 | | -| main_coupon_deadline | datetime | 兑换后使用截止时间 | | +| main_coupon_deadline | str | 兑换后使用截止时间 | | | deadline | str | 兑换后使用截止时间 | | -| point | str | 未知 | 目前恒为0 | +| point | str | (?) | 目前恒为0 | + +**示例：** + +```bash +curl 'http://manga.bilibili.com/twirp/pointshop.v1.Pointshop/ListProduct' +```
-返回示例： +查看响应示例： + ```json { @@ -220,17 +249,16 @@
-# 兑换物品 -> https://manga.bilibili.com/twirp/pointshop.v1.Pointshop/Exchange +## 兑换物品 + +> http://manga.bilibili.com/twirp/pointshop.v1.Pointshop/Exchange *请求方式：POST* 认证方式：Cookie（SESSDATA）/ APP -**正文参数（ application/x-www-form-urlencoded ）：** - -以json方式请求也可以 +**正文参数（ application/x-www-form-urlencoded 或 application/json）：** | 参数名 | 类型 | 内容 | 必要性 | 备注 | | ---------- | ---- | ------------------------ | -------------- | ------------------------------------------------------------ | @@ -244,21 +272,40 @@ | 字段 | 类型 | 内容 | 备注 | | ------- | ---- | -------- | ------------------------------------------------------------ | -| code | num | 返回值 | 0：兑换成功
1：积分不足
2：库存不足
3：product point mismatch（point填写错误）
3：超过用户最大可兑换数量
4：现在抢票的人太多啦，再点一下有机会优先上车喔 ε=ε=(ノ≧∇≦)ノ| -| message | str | 错误信息 | | | -| data | obj | 信息本体 | +| code | num | 返回值 | 0：兑换成功
1：积分不足
2：库存不足
3：product point mismatch（point填写错误）
3：超过用户最大可兑换数量
4：现在抢票的人太多啦，再点一下有机会优先上车喔 ε=ε=(ノ≧∇≦)ノ | +| message | str | 错误信息 | | -# 获取兑换历史记录 +**示例：** -> 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' +``` + +
+查看响应示例： + +```json +{ + "code": 0, + "msg": "" +} +``` + +
+ +## 获取兑换历史记录 + +> http://manga.bilibili.com/twirp/activity.v1.Activity/GetPrizeList *请求方式：POST* 认证方式：Cookie（SESSDATA）/ APP -**正文参数（ application/x-www-form-urlencoded ）：** - -以json方式请求也可以 +**正文参数（ application/x-www-form-urlencoded 或 application/json）：** | 参数名 | 类型 | 内容 | 必要性 | 备注 | | ---------- | ---- | ------------------------ | -------------- | ------------------------------------------------------------ | @@ -274,18 +321,33 @@ | msg | str | 错误信息 | | | | data | obj | 信息本体 | -`data`对象`prizes`节点： +`data`对象： + +| 字段 | 类型 | 内容 | 备注 | +| ------ | ---- | -------- | ---- | +| prizes | obj | 兑换记录 | | +| addr | obj | (?) | | + +`data`中的`prizes`对象： | 字段 | 类型 | 内容 | 备注 | | -------- | ---- | -------- | ------------ | -| user_prize_id | str | | | +| user_prize_id | str | 兑换id? | | | prize_id | num | 兑换的物品id | | -| ctime | datetime | 兑换时间 | | -| addr | | 未知 | | -| deadline | datetime | 未知 | | -| type | num | 未知 | 1：限免券、福利券
8：商城5魔晶 | +| ctime | str | 兑换时间 | | +| addr | null | (?) | | +| deadline | str | 过期时间 | | +| type | num | 类型 | 1：限免券、福利券
8：商城5魔晶 | | name | str | 物品名 | | +**示例：** + +```bash +curl 'http://manga.bilibili.com/twirp/activity.v1.Activity/GetPrizeList' \ +--data-urlencode 'act_id=90018' \ +-b 'SESSDATA=xxx' +``` +
查看响应示例： @@ -344,16 +406,37 @@
-# 获取玩法说明 +## 获取玩法说明 -> https://manga.bilibili.com/twirp/pointshop.v1.Pointshop/GetExchangeRule +> http://manga.bilibili.com/twirp/pointshop.v1.Pointshop/GetExchangeRule *请求方式：POST* -认证方式：可不登录访问 +**json回复：** + +根对象： + +| 字段 | 类型 | 内容 | 备注 | +| ---- | ---- | -------- | ---- | +| code | num | 返回值 | | +| msg | str | 错误信息 | | +| data | obj | 信息本体 | | + +`data`对象： + +| 字段 | 类型 | 内容 | 备注 | +| ---- | ---- | -------- | ---- | +| rule | str | 玩法说明 | | + +**示例：** + +```bash +curl 'http://manga.bilibili.com/twirp/pointshop.v1.Pointshop/GetExchangeRule' +```
-返回示例： +查看响应示例： + ```json {