mirror of
https://github.com/SocialSisterYi/bilibili-API-collect.git
synced 2024-12-28 13:30:08 +08:00
添加: 获取拥有的漫读券列表 (#373)
* 添加漫画签到接口
* 添加积分商城相关接口
* 添加基本兑换状态码
* fix format
* 添加新项
* 链接勘误
* 添加Java获取dev_id的示例
* Revert "添加Java获取dev_id的示例"
This reverts commit 125828bb
* 添加Java获取dev_id的示例
* 大会员权益信息更新
* 查询自己收到的充电列表
* 更新视频取流相关参数
* 签到请求地址更正
* 添加查询签到状态接口
* 补充用户信息字段
* 补充粉丝勋章信息字段说明
* 添加系统提示类型
* UPDATE
* UPDATE
* UPDATE
* 添加: 查询我收到的充电留言
* 添加: 查询充电留言详情
* 添加: 回复充电留言
* UPDATE
* UPDATE
* 添加: 购买漫画章节
* 添加: 获取拥有的漫读券列表
* 添加: 获取漫画详情
Co-authored-by: 社会易姐QwQ <45892418+SocialSisterYi@users.noreply.github.com>
This commit is contained in:
7rikka
GitHub
parent
7d0d6908e0
commit
2a78655ae6
4118
manga/Comic.md
4118
manga/Comic.md
File diff suppressed because it is too large
Load Diff
177
manga/User.md
Normal file
177
manga/User.md
Normal file
@ -0,0 +1,177 @@
|
|||||||
|
# 获取拥有的漫读券列表
|
||||||
|
|
||||||
|
> https://manga.bilibili.com/twirp/user.v1.User/GetCoupons
|
||||||
|
|
||||||
|
*请求方式：POST*
|
||||||
|
|
||||||
|
认证方式：Cookie（SESSDATA）/ APP
|
||||||
|
|
||||||
|
**URL参数：**
|
||||||
|
|
||||||
|
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
|
||||||
|
| ---------- | ---- | ------------------------ | -------------- | ------------------------------------------------------------ |
|
||||||
|
| access_key | str | APP登录凭证 | 必要 | 使用APP鉴权方式时必填 |
|
||||||
|
| appkey | str | cc8617fd6961e070 | 非必要 | |
|
||||||
|
| mobi_app | str | android_comic | 非必要 | |
|
||||||
|
| version | str | 4.13.0 | 非必要 | |
|
||||||
|
| build | str | 36413002 | 非必要 | |
|
||||||
|
| channel | str | bilicomic | 非必要 | |
|
||||||
|
| platform | str | android | 非必要 | |
|
||||||
|
| device | str | android | 非必要 | |
|
||||||
|
| buvid | str | | 非必要 | |
|
||||||
|
| machine | str | samsung+SM-G9730 | 非必要 | |
|
||||||
|
| is_teenager | num | 0 | 非必要 | |
|
||||||
|
| no_recommend | num | 0 | 非必要 | |
|
||||||
|
| ts | num | 秒级时间戳 | 非必要 | |
|
||||||
|
|
||||||
|
**正文参数（ application/json ）：**
|
||||||
|
|
||||||
|
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
|
||||||
|
| -------- | ---- | ------------------------ | ------ | ------------------------------------------------- |
|
||||||
|
| pageNum | num | 页数 | 必要 | |
|
||||||
|
| pageSize | num | 分页大小 | 必要 | 默认20，取值范围[1,100] |
|
||||||
|
| notExpired | bool | true | 非必要 | |
|
||||||
|
| tabType | num | 1 | 非必要 | |
|
||||||
|
| type | num | 0 | 非必要 | |
|
||||||
|
|
||||||
|
|
||||||
|
**json回复：**
|
||||||
|
|
||||||
|
根对象：
|
||||||
|
|
||||||
|
| 字段 | 类型 | 内容 | 备注 |
|
||||||
|
| ------- | ---- | -------- | ------------------------------------------------------------ |
|
||||||
|
| code | num | 返回值 | 0：成功 |
|
||||||
|
| msg | str | 错误信息 | |
|
||||||
|
| data | obj | | |
|
||||||
|
|
||||||
|
|
||||||
|
`data` 对象：
|
||||||
|
|
||||||
|
| 字段 | 类型 | 内容 | 备注 |
|
||||||
|
| ------- | ---- | -------- | ------------------------------------------------------------ |
|
||||||
|
| total_remain_amount | num | | |
|
||||||
|
| user_coupons | array | | |
|
||||||
|
| coupon_info | obj | | |
|
||||||
|
|
||||||
|
`user_coupons` 数组中的对象：
|
||||||
|
|
||||||
|
| 字段 | 类型 | 内容 | 备注 |
|
||||||
|
| ------- | ---- | -------- | ------------------------------------------------------------ |
|
||||||
|
| ID | num | 漫读券id | |
|
||||||
|
| remain_amount | num | 漫读券剩余数 | |
|
||||||
|
| expire_time | num | 过期时间 | |
|
||||||
|
| reason | num | 获取方式 | |
|
||||||
|
| type | num | 类型 | |
|
||||||
|
| ctime | num | 获取时间 | |
|
||||||
|
| total_amount | num | 漫读券总数 | |
|
||||||
|
| limits | array | (?) | |
|
||||||
|
| type_num | num | 7：福利券 | |
|
||||||
|
| will_expire | num | 是否即将过期？<br />0：否<br />1：是 | |
|
||||||
|
| discount | num | 0 | |
|
||||||
|
| discount_limit | num | 0 | |
|
||||||
|
| is_from_card | num | 0 | |
|
||||||
|
| valid_time | str | 0001-01-01 | |
|
||||||
|
| discount_base | num | 0 | |
|
||||||
|
|
||||||
|
`coupon_info` 对象：
|
||||||
|
|
||||||
|
| 字段 | 类型 | 内容 | 备注 |
|
||||||
|
| ------- | ---- | -------- | ------------------------------------------------------------ |
|
||||||
|
| new_coupon_num | num | | |
|
||||||
|
| coupon_will_expire | num | | |
|
||||||
|
| rent_will_expire | num | | |
|
||||||
|
| new_rent_num | num | | |
|
||||||
|
| discount_will_expire | num | | |
|
||||||
|
| new_discount_num | num | | |
|
||||||
|
| month_ticket_will_expire | num | | |
|
||||||
|
| new_month_ticket_num | num | | |
|
||||||
|
| silver_will_expire | num | | |
|
||||||
|
| new_silver_num | num | | |
|
||||||
|
| remain_item | num | | |
|
||||||
|
| remain_discount | num | | |
|
||||||
|
| remain_coupon | num | 拥有的漫读券数量 | |
|
||||||
|
| remain_silver | num | 拥有的通用券数量 | |
|
||||||
|
| remain_shop_coupon | num | 拥有的商城优惠券数量 | |
|
||||||
|
| new_shop_num | num | | |
|
||||||
|
| shop_will_expire | num | | |
|
||||||
|
| new_suit_id | num | | |
|
||||||
|
| remain_suit_coupon | num | | |
|
||||||
|
| new_suit_num | num | | |
|
||||||
|
| suit_will_expire | num | | |
|
||||||
|
| vip_priv_coupon | bool | | |
|
||||||
|
|
||||||
|
|
||||||
|
**示例：**
|
||||||
|
|
||||||
|
```bash
|
||||||
|
curl -L -X POST 'https://manga.bilibili.com/twirp/user.v1.User/GetCoupons' \
|
||||||
|
-H 'Cookie: SESSDATA=xxx;' \
|
||||||
|
-H 'Content-Type: application/json' \
|
||||||
|
--data-raw '{
|
||||||
|
"notExpired": true,
|
||||||
|
"pageNum": 1,
|
||||||
|
"pageSize": 20,
|
||||||
|
"tabType": 1,
|
||||||
|
"type": 0
|
||||||
|
}'
|
||||||
|
```
|
||||||
|
|
||||||
|
<details>
|
||||||
|
<summary>查看响应示例：</summary>
|
||||||
|
|
||||||
|
|
||||||
|
```json
|
||||||
|
{
|
||||||
|
"code": 0,
|
||||||
|
"msg": "",
|
||||||
|
"data": {
|
||||||
|
"total_remain_amount": 1,
|
||||||
|
"user_coupons": [
|
||||||
|
{
|
||||||
|
"ID": 7473503,
|
||||||
|
"remain_amount": 1,
|
||||||
|
"expire_time": "2022-05-24 12:00:33",
|
||||||
|
"reason": "积分兑换",
|
||||||
|
"type": "福利券",
|
||||||
|
"ctime": "2022-05-17 12:00:33",
|
||||||
|
"total_amount": 1,
|
||||||
|
"limits": [],
|
||||||
|
"type_num": 7,
|
||||||
|
"will_expire": 0,
|
||||||
|
"discount": 0,
|
||||||
|
"discount_limit": 0,
|
||||||
|
"is_from_card": 0,
|
||||||
|
"valid_time": "0001-01-01",
|
||||||
|
"discount_base": 0
|
||||||
|
}
|
||||||
|
],
|
||||||
|
"coupon_info": {
|
||||||
|
"new_coupon_num": 0,
|
||||||
|
"coupon_will_expire": 0,
|
||||||
|
"rent_will_expire": 0,
|
||||||
|
"new_rent_num": 0,
|
||||||
|
"discount_will_expire": 0,
|
||||||
|
"new_discount_num": 0,
|
||||||
|
"month_ticket_will_expire": 0,
|
||||||
|
"new_month_ticket_num": 0,
|
||||||
|
"silver_will_expire": 0,
|
||||||
|
"new_silver_num": 0,
|
||||||
|
"remain_item": 0,
|
||||||
|
"remain_discount": 0,
|
||||||
|
"remain_coupon": 1,
|
||||||
|
"remain_silver": 8,
|
||||||
|
"remain_shop_coupon": 1,
|
||||||
|
"new_shop_num": 0,
|
||||||
|
"shop_will_expire": 0,
|
||||||
|
"new_suit_id": 60007,
|
||||||
|
"remain_suit_coupon": 0,
|
||||||
|
"new_suit_num": 0,
|
||||||
|
"suit_will_expire": 0,
|
||||||
|
"vip_priv_coupon": false
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
</details>
|
||||||
Loading…
Reference in New Issue
Block a user