Skip to content

Latest commit

 

History

History
373 lines (292 loc) · 12.7 KB

monthly.md

File metadata and controls

373 lines (292 loc) · 12.7 KB
Raw

包月充电

UP主包月充电详情

https://api.bilibili.com/x/upower/item/detail

请求方式：GET

url参数：

参数名 类型 内容 必要性 备注
up_mid num 目标用户mid 必要

json回复：

根对象：

字段 类型 内容 备注
code num 返回值 0：成功
-400：请求错误
203101：UP主未开通包月充电功能
message str 错误信息 默认为0
ttl num 1
data obj 信息本体

data对象：

字段 类型 内容 备注
upower_rank obj 充电详情
item obj 充电欢迎语
user_card obj UP主信息

data中的upower_rank对象：

字段 类型 内容 备注
total num 充电用户总数
total_desc str 充电总数文字说明 示例：“1+”
list array 充电用户列表 最多展示30个

upower_rank中的list数组：

项 类型 内容 备注
0 obj 用户1
n obj 用户(n+1) 按照充电时间排序
…… obj …… ……

数组list中的对象：

字段 类型 内容 备注
rank num 充电用户索引
mid num 充电用户mid
nickname str 充电用户昵称
avatar str 充电用户头像url

data中的item对象：

字段 类型 内容 备注
intro_video_aid str 充电介绍视频AV号
welcomes str 充电介绍语

data中的user_card对象：

字段 类型 内容 备注
avatar str UP主头像url
nickname str UP主昵称

示例：

获取mid=293793435的包月充电详情

curl 'https://api.bilibili.com/x/upower/item/detail' \
--data-urlencode 'up_mid=293793435' \
-b 'SESSDATA=xxx'
查看响应示例： 
{
    "code": 0,
    "message": "0",
    "ttl": 1,
    "data": {
        "upower_rank": {
            "total": 1,
            "total_desc": "1+",
            "list": [
                {
                    "rank": 1,
                    "mid": 425503913,
                    "nickname": "wuziqian211",
                    "avatar": "https://i2.hdslb.com/bfs/face/390f4b18b8b15c1f2ecdb6ee44e572aa18b9b2d0.png"
                }
            ]
        },
        "item": {
            "intro_video_aid": "",
            "welcomes": "哈喽b站的小伙伴们，我的充电计划升级啦！ 感兴趣就多多支持我吧~(゜-゜)つロ"
        },
        "user_card": {
            "avatar": "https://i0.hdslb.com/bfs/face/aebb2639a0d47f2ce1fec0631f412eaf53d4a0be.jpg",
            "nickname": "社会易姐QwQ"
        }
    }
}

与UP主的包月充电关系

https://api.bilibili.com/x/upower/charge/follow/info

请求方式：GET

认证方式：Cookie(SESSDATA)或APP

url参数：

参数名 类型 内容 必要性 备注
up_mid num 目标用户mid 必要

json回复：

根对象：

字段 类型 内容 备注
code num 返回值 0：成功
-101：账号未登录
-400：请求错误
message str 错误信息 默认为0
ttl num 1
data obj 信息本体

data对象：

字段 类型 内容 备注
days num 已保持多少天包月充电状态
up_card obj UP主信息
user_card obj 自己的信息
remain_days num 剩余天数 未处于包月充电状态为-1
remain_less_1day num 剩余的天数小于1天 0：否
1：是
未处于包月充电状态为0
upower_rank obj 充电详情
upower_icon str 充电图标url

data中的up_card对象：

字段 类型 内容 备注
nickname str UP主昵称
official_title str UP主认证信息
avatar str UP主头像url

data中的user_card对象：

字段 类型 内容 备注
avatar str 用户头像url
nickname str 用户昵称

data中的upower_rank对象：

字段 类型 内容 备注
total num 充电用户总数
total_desc str 充电总数文字说明 示例：“1+”
list array 充电用户列表 最多展示6个

upower_rank中的list数组：

项 类型 内容 备注
0 obj 用户1
n obj 用户(n+1) 按照充电时间排序
…… obj …… ……

数组list中的对象：

字段 类型 内容 备注
rank num 充电用户索引
mid num 充电用户mid
nickname str 充电用户昵称
avatar str 充电用户头像url

示例：

获取与mid=293793435的包月充电关系

curl 'https://api.bilibili.com/x/upower/charge/follow/info' \
--data-urlencode 'up_mid=293793435' \
-b 'SESSDATA=xxx'
查看响应示例： 
{
    "code": 0,
    "message": "0",
    "ttl": 1,
    "data": {
        "days": 17,
        "up_card": {
            "nickname": "社会易姐QwQ",
            "official_title": "",
            "avatar": "https://i0.hdslb.com/bfs/face/aebb2639a0d47f2ce1fec0631f412eaf53d4a0be.jpg"
        },
        "user_card": {
            "avatar": "https://i2.hdslb.com/bfs/face/390f4b18b8b15c1f2ecdb6ee44e572aa18b9b2d0.png",
            "nickname": "wuziqian211"
        },
        "remain_days": 15,
        "remain_less_1day": 0,
        "upower_rank": {
            "total": 1,
            "total_desc": "1+",
            "list": [
                {
                    "rank": 1,
                    "mid": 425503913,
                    "nickname": "wuziqian211",
                    "avatar": "https://i2.hdslb.com/bfs/face/390f4b18b8b15c1f2ecdb6ee44e572aa18b9b2d0.png"
                }
            ]
        },
        "upower_icon": "https://i0.hdslb.com/bfs/garb/item/33e2e72d9a0c855f036b4cb55448f44af67a0635.png"
    }
}

包月充电用户排名

https://api.bilibili.com/x/upower/up/member/rank/v2

请求方式：GET

url参数：

参数名 类型 内容 必要性 备注
up_mid num 目标用户mid 必要
ps num 每页项数 非必要 默认为20
pn num 页码 非必要 默认为1

json回复：

根对象：

字段 类型 内容 备注
code num 返回值 0：成功
-400：请求错误
message str 错误信息 默认为0
ttl num 1
data obj 信息本体

data对象：

字段 类型 内容 备注
up_info obj UP主信息
rank_info array 充电用户排名
user_info obj 自己的信息
member_total num 充电用户总数

data中的up_info对象：

字段 类型 内容 备注
mid num UP主mid
nickname str UP主昵称
avatar str UP主头像url
type num UP主认证类型 -1：无
0：UP主认证
1：机构认证
title str UP主认证信息

data中的rank_info数组：

项 类型 内容 备注
0 obj 用户1
n obj 用户(n+1) 按照充电排名排列
…… obj …… ……

数组rank_info中的对象：

字段 类型 内容 备注
mid num 充电用户mid
nickname str 充电用户昵称
avatar str 充电用户头像url
rank num 充电用户排名
day num 包月充电天数
expire_at num 包月充电过期时间 恒为0

data中的user_info对象：

字段 类型 内容 备注
mid num 用户mid
nickname str 用户昵称
avatar str 用户头像url
rank num 包月充电排名 不在包月充电用户列表里为-1
day num 包月充电天数
expire_at num 包月充电过期时间 单位为秒，若从未给UP主包月充电为0

示例：

获取给mid=293793435包月充电的用户排名

curl 'https://api.bilibili.com/x/upower/up/member/rank/v2' \
--data-urlencode 'up_mid=293793435' \
-b 'SESSDATA=xxx'
查看响应示例： 
{
    "code": 0,
    "message": "0",
    "ttl": 1,
    "data": {
        "up_info": {
            "mid": 293793435,
            "nickname": "社会易姐QwQ",
            "avatar": "https://i0.hdslb.com/bfs/face/aebb2639a0d47f2ce1fec0631f412eaf53d4a0be.jpg",
            "type": -1,
            "title": ""
        },
        "rank_info": [
            {
                "mid": 425503913,
                "nickname": "wuziqian211",
                "avatar": "https://i2.hdslb.com/bfs/face/390f4b18b8b15c1f2ecdb6ee44e572aa18b9b2d0.png",
                "rank": 1,
                "day": 31,
                "expire_at": 0
            }
        ],
        "user_info": {
            "mid": 425503913,
            "nickname": "wuziqian211",
            "avatar": "https://i2.hdslb.com/bfs/face/390f4b18b8b15c1f2ecdb6ee44e572aa18b9b2d0.png",
            "rank": 1,
            "day": 31,
            "expire_at": 1678723199
        },
        "member_total": 1
    }
}