github-repos/bilibili-API-collect
1
0
Fork 0
mirror of https://github.com/SocialSisterYi/bilibili-API-collect.git synced 2024-12-28 13:30:08 +08:00
Code Issues Packages Projects Releases Wiki Activity
fc0c6874d9
bilibili-API-collect/docs/manga/point_shop.md
SocialSisterYi f6760f4be3
🔨remove header index
2023-02-23 11:48:58 +08:00

13 KiB
Raw Blame History

积分商城

注：积分商城由web页面提供功能，地址为 https://manga.bilibili.com/eden/credits-exchange.html

获取当前持有点数

https://manga.bilibili.com/twirp/pointshop.v1.Pointshop/GetUserPoint

请求方式：POST

认证方式：Cookie（SESSDATA）/ APP

json回复：

根对象：

字段 类型 内容 备注
code num 返回值
msg str 错误信息
data obj 信息本体

data对象：

字段 类型 内容 备注
point str 点数 不登录时为0

示例：

curl 'https://manga.bilibili.com/twirp/pointshop.v1.Pointshop/GetUserPoint' \
-b 'SESSDATA=xxx'
查看响应示例： 
{
  "code": 0,
  "msg": "",
  "data": {
    "point": "66666"
  }
}

获取兑换奖品列表

https://manga.bilibili.com/twirp/pointshop.v1.Pointshop/ListProduct

请求方式：POST

json回复：

根对象：

字段 类型 内容 备注
code num 返回值
msg str 错误信息
data array 奖品列表

data数组：

项 类型 内容 备注
0 obj 奖品1
n obj 奖品(n+1)
…… obj …… ……

data数组中的对象：

字段 类型 内容 备注
id num 物品id
type num 物品类型 0：商城相关
3：限免券
7：福利券
title str 物品名
image str 显示的图像 福利券为空
amount num 库存总量
cost num 兑换所需点数（原价）
real_cost num 兑换所需点数（现价）
remain_amount num 库存剩余数
comic_id num 相关漫画id
limits array 限定使用范围（漫画） 限免券所适用的漫画
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魔晶
exchange_limit num 兑换次数限制
address_deadline str (?)
act_type num (?) 目前恒为0
has_exchanged bool 是否兑换过该物品
main_coupon_deadline str 兑换后使用截止时间
deadline str 兑换后使用截止时间
point str (?) 目前恒为0

示例：

curl 'https://manga.bilibili.com/twirp/pointshop.v1.Pointshop/ListProduct'
查看响应示例： 
{
  "code": 0,
  "msg": "",
  "data": [
    {
      "id": 195,
      "type": 7,
      "title": "积分兑换",
      "image": "",
      "amount": 15999,
      "cost": 200,
      "real_cost": 100,
      "remain_amount": 0,
      "comic_id": 0,
      "limits": [],
      "discount": 0,
      "product_type": 1,
      "pendant_url": "",
      "pendant_expire": 7,
      "exchange_limit": 0,
      "address_deadline": "0001-01-01T00:00:00Z",
      "act_type": 0,
      "has_exchanged": false,
      "main_coupon_deadline": "0001-01-01T00:00:00Z",
      "deadline": "",
      "point": "0"
    },
    {
      "id": 1009,
      "type": 0,
      "title": "商城5魔晶",
      "image": "",
      "amount": 500,
      "cost": 260,
      "real_cost": 30,
      "remain_amount": 0,
      "comic_id": 0,
      "limits": [],
      "discount": 0,
      "product_type": 5,
      "pendant_url": "",
      "pendant_expire": 0,
      "exchange_limit": 1,
      "address_deadline": "0001-01-01T00:00:00Z",
      "act_type": 0,
      "has_exchanged": false,
      "main_coupon_deadline": "2022-03-22T23:59:59+08:00",
      "deadline": "2022-03-22T23:59:59+08:00",
      "point": "0"
    },
    {
      "id": 1008,
      "type": 0,
      "title": "商城满99立减10元券",
      "image": "",
      "amount": 400,
      "cost": 2000,
      "real_cost": 400,
      "remain_amount": 390,
      "comic_id": 0,
      "limits": [],
      "discount": 0,
      "product_type": 4,
      "pendant_url": "",
      "pendant_expire": 0,
      "exchange_limit": 1,
      "address_deadline": "0001-01-01T00:00:00Z",
      "act_type": 0,
      "has_exchanged": false,
      "main_coupon_deadline": "2022-03-22T23:59:59+08:00",
      "deadline": "2022-03-22T23:59:59+08:00",
      "point": "0"
    },
    {
      "id": 1007,
      "type": 0,
      "title": "商城5元无门槛券",
      "image": "",
      "amount": 200,
      "cost": 1000,
      "real_cost": 200,
      "remain_amount": 134,
      "comic_id": 0,
      "limits": [],
      "discount": 0,
      "product_type": 4,
      "pendant_url": "",
      "pendant_expire": 0,
      "exchange_limit": 1,
      "address_deadline": "0001-01-01T00:00:00Z",
      "act_type": 0,
      "has_exchanged": false,
      "main_coupon_deadline": "2022-03-22T23:59:59+08:00",
      "deadline": "2022-03-22T23:59:59+08:00",
      "point": "0"
    },
    {
      "id": 1536,
      "type": 3,
      "title": "白兔糖",
      "image": "http://i0.hdslb.com/bfs/manga-static/c3369754789a77b5d0b15cc31c75538ac035b3aa.jpg",
      "amount": 4000,
      "cost": 100,
      "real_cost": 75,
      "remain_amount": 3991,
      "comic_id": 27164,
      "limits": [
        {
          "type": 1,
          "id": 27164,
          "title": "白兔糖"
        }
      ],
      "discount": 0,
      "product_type": 1,
      "pendant_url": "",
      "pendant_expire": 7,
      "exchange_limit": 0,
      "address_deadline": "0001-01-01T00:00:00Z",
      "act_type": 0,
      "has_exchanged": false,
      "main_coupon_deadline": "0001-01-01T00:00:00Z",
      "deadline": "",
      "point": "0"
    }
  ]
}

兑换物品

https://manga.bilibili.com/twirp/pointshop.v1.Pointshop/Exchange

请求方式：POST

认证方式：Cookie（SESSDATA）/ APP

正文参数（ application/x-www-form-urlencoded 或 application/json）：

参数名 类型 内容 必要性 备注
product_id str 物品id 必要
product_num num 兑换个数 必要
point num 物品所需点数 必要 现价（real_cost）

json回复：

根对象：

字段 类型 内容 备注
code num 返回值 0：兑换成功
1：积分不足
1：您点的太快了~
2：库存不足
3：product point mismatch（point填写错误）
3：超过用户最大可兑换数量
4：现在抢票的人太多啦，再点一下有机会优先上车喔 ε=ε=(ノ≧∇≦)ノ
message str 错误信息

示例：

curl 'https://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'
查看响应示例： 
{
  "code": 0,
  "msg": ""
}

获取兑换历史记录

https://manga.bilibili.com/twirp/activity.v1.Activity/GetPrizeList

请求方式：POST

认证方式：Cookie（SESSDATA）/ APP

正文参数（ application/x-www-form-urlencoded 或 application/json）：

参数名 类型 内容 必要性 备注
act_id num 固定值：90018 必要

json回复：

根对象：

字段 类型 内容 备注
code num 返回值
msg str 错误信息
data obj 信息本体

data对象：

字段 类型 内容 备注
prizes obj 兑换记录
addr obj (?)

data中的prizes对象：

字段 类型 内容 备注
user_prize_id str 兑换id?
prize_id num 兑换的物品id
ctime str 兑换时间
addr null (?)
deadline str 过期时间
type num 类型 1：限免券、福利券
8：商城5魔晶
name str 物品名

示例：

curl 'https://manga.bilibili.com/twirp/activity.v1.Activity/GetPrizeList' \
--data-urlencode 'act_id=90018' \
-b 'SESSDATA=xxx'
查看响应示例： 
{
  "code": 0,
  "msg": "",
  "data": {
    "prizes": [
      {
        "user_prize_id": "55117444",
        "prize_id": 1009,
        "ctime": "2022-03-21T12:22:53+08:00",
        "addr": null,
        "deadline": "0001-01-01T00:00:00Z",
        "type": 8,
        "name": "商城5魔晶"
      },
      {
        "user_prize_id": "2594073385420523088",
        "prize_id": 1536,
        "ctime": "2022-03-21T12:07:24+08:00",
        "addr": null,
        "deadline": "0001-01-01T00:00:00Z",
        "type": 1,
        "name": "白兔糖限免卡"
      },
      {
        "user_prize_id": "4899916394614914913",
        "prize_id": 195,
        "ctime": "2021-12-24T12:01:08+08:00",
        "addr": null,
        "deadline": "0001-01-01T00:00:00Z",
        "type": 1,
        "name": "积分兑换"
      },
      {
        "user_prize_id": "1152921504636496551",
        "prize_id": 195,
        "ctime": "2021-12-13T12:05:13+08:00",
        "addr": null,
        "deadline": "0001-01-01T00:00:00Z",
        "type": 1,
        "name": "积分兑换"
      }
    ],
    "addr": {
      "name": "",
      "phone": "",
      "address": "",
      "id_card": ""
    }
  }
}

获取玩法说明

https://manga.bilibili.com/twirp/pointshop.v1.Pointshop/GetExchangeRule

请求方式：POST

json回复：

根对象：

字段 类型 内容 备注
code num 返回值
msg str 错误信息
data obj 信息本体

data对象：

字段 类型 内容 备注
rule str 玩法说明

示例：

curl 'https://manga.bilibili.com/twirp/pointshop.v1.Pointshop/GetExchangeRule'
查看响应示例： 
{
  "code": 0,
  "msg": "",
  "data": {
    "rule": "日常兑换说明：\n1、赛季积分达到一定数量可兑换积分商城内相应的商品；\n2、日常兑换奖品的刷新时间为每日中午12点，每天可兑换的奖品总数有限（具体可见商品页面展示），请尽快兑换。\n3、兑换的福利券＆限免卡奖品有效期详见兑换框内显示或卡券包内详情说明哦，请及时在有效期内使用。\n4、赛季积分有效期为当前赛季时长（每期赛季时长详见福利中心页面倒计时显示），请及时在有效期内进行使用。\n5、赛季积分可在福利中心完成特定任务获取，具体详情可至福利中心查看（部分活动也可获取赛季积分，可随时关注活动信息哦）。"
  }
}