Skip to content

Latest commit

 

History

History
368 lines (319 loc) · 12.9 KB

charge_list.md

File metadata and controls

368 lines (319 loc) · 12.9 KB
Raw

充电列表

获取空间充电公示列表

http://elec.bilibili.com/api/query.rank.do

请求方式:GET

url参数：

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

json回复：

根对象：

字段 类型 内容 备注
code num 返回值 0：成功
500011：UID错误
msg str 错误信息 正确时无此项
data obj 数据本体

data对象：

字段 类型 内容 备注
display_num num 0 作用尚不明确
count num 本月充电人数
total_count num 总计充电人数
list array 本月充电用户列表
user null 作用尚不明确

data中的list数组：

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

data中的list数组中的对象：

字段 类型 内容 备注
mid num 充电对象UID
pay_mid num 充电用户UID
rank num 充电用户排名 取决于充电的多少
uname str 充电用户昵称
avatar str 充电用户头像url
message str 充电留言 无为空
msg_deleted num 0 作用尚不明确
vip_info obj 充电用户会员信息
trend_type num 0 作用尚不明确

data中的list数组中的对象中的vip_info对象：

字段 类型 内容 备注
vipType num 大会员类型 0：无
1：月会员
2：年会员
vipDueMsec num 0 作用尚不明确
vipStatus num 大会员状态 0：无
1：有

示例：

查询用户UID=53456的充电公示列表

curl -G 'http://elec.bilibili.com/api/query.rank.do'\
--data-urlencode 'mid=53456'
查看响应示例： 
{
    "code": 0,
    "data": {
        "display_num": 0,
        "count": 226,
        "total_count": 11528,
        "list": [
            {
                "mid": 53456,
                "pay_mid": 346545025,
                "rank": 1,
                "uname": "还有什么名字没人用",
                "avatar": "http://i1.hdslb.com/bfs/face/76d4b1ecd13e992a6c7303d77bf716dd922ab234.jpg",
                "message": "早日康复，五月快乐",
                "msg_deleted": 0,
                "vip_info": {
                    "vipType": 2,
                    "vipDueMsec": 0,
                    "vipStatus": 1
                },
                "trend_type": 0
            },
            {
                "mid": 53456,
                "pay_mid": 8826056,
                "rank": 2,
                "uname": "煋痕",
                "avatar": "http://i2.hdslb.com/bfs/face/35b7c752d0eb1bb7a924804f240b9bfd9199625f.jpg",
                "message": "",
                "msg_deleted": 0,
                "vip_info": {
                    "vipType": 2,
                    "vipDueMsec": 0,
                    "vipStatus": 1
                },
                "trend_type": 0
            },
            {
                "mid": 53456,
                "pay_mid": 356668487,
                "rank": 3,
                "uname": "舞象祥",
                "avatar": "http://i1.hdslb.com/bfs/face/574f6203ef5bd0d56b95ded6a2736676d9cc5307.jpg",
                "message": "warma  hayo",
                "msg_deleted": 0,
                "vip_info": {
                    "vipType": 1,
                    "vipDueMsec": 0,
                    "vipStatus": 1
                },
                "trend_type": 0
            },
            …………
        ],
        "user": null
    }
}

获取视频充电鸣谢名单

http://api.bilibili.com/x/web-interface/elec/show

请求方式:GET

url参数：

参数名 类型 内容 必要性 备注
mid num 目标用户UID 必要
aid num 目标视频avID 必要（可选） avID与bvID任选一个
bvid str 目标视频bvID 必要（可选） avID与bvID任选一个

json回复：

根对象：

字段 类型 内容 备注
code num 返回值 0：成功
-400：请求错误
-404：无视频
62001：不需要展示充电信息
message str 错误信息 默认为0
ttl num 1
data obj 信息本体

data对象：

字段 类型 内容 备注
show_info obj 展示选项
av_count num 目标视频充电人数
count num 本月充电人数
total_count num 总计充电人数
special_day num 0 作用尚不明确
display_num num 0 作用尚不明确
av_list array 目标视频充电列表
list array 本月充电用户列表

data中的show_info对象：

字段 类型 内容 备注
show bool 是否展示视频充电鸣谢名单 false：不展示
true：展示
state num 0

data中的list数组（av_list数组）：

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

data中的list数组（av_list数组）中的对象：

字段 类型 内容 备注
mid num 充电对象UID
pay_mid num 充电用户UID
rank num 充电用户排名 取决于充电的多少
uname str 充电用户昵称
avatar str 充电用户头像url
message str 充电留言 无为空
msg_deleted num 0 作用尚不明确
vip_info obj 充电用户会员信息
trend_type num 0 作用尚不明确

data中的list数组（av_list数组）中的对象中的vip_info对象：

字段 类型 内容 备注
vipType num 大会员类型 0：无
1：月会员
2：年会员
vipDueMsec num 0 作用尚不明确
vipStatus num 大会员状态 0：无
1：有

示例：

获取视频av967773538/BV1up4y1y77i，用户UID=53456的视频充电鸣谢名单

avID方式：

curl -G 'http://api.bilibili.com/x/web-interface/elec/show'\
--data-urlencode 'mid=53456'\
--data-urlencode 'aid=967773538'

bvID方式：

curl -G 'http://api.bilibili.com/x/web-interface/elec/show'\
--data-urlencode 'mid=53456'\
--data-urlencode 'bvid=BV1up4y1y77i '
查看响应示例： 
{
    "code": 0,
    "message": "0",
    "ttl": 1,
    "data": {
        "show_info": {
            "show": true,
            "state": 0
        },
        "av_count": 4,
        "count": 226,
        "total_count": 11528,
        "special_day": 0,
        "display_num": 0,
        "av_list": [
            {
                "mid": 53456,
                "pay_mid": 326994943,
                "rank": 1,
                "uname": "此人不在线hhh",
                "avatar": "http://i0.hdslb.com/bfs/face/d2540c20f569554e62dd88cc78cbf2fe07268903.jpg",
                "message": "",
                "msg_deleted": 0,
                "vip_info": {
                    "vipType": 1,
                    "vipDueMsec": 0,
                    "vipStatus": 1
                },
                "trend_type": 0
            },
            {
                "mid": 53456,
                "pay_mid": 328473637,
                "rank": 2,
                "uname": "SkJ_17",
                "avatar": "http://i1.hdslb.com/bfs/face/42b50918e8b7288009e55332322f991dcbce960a.jpg",
                "message": "",
                "msg_deleted": 0,
                "vip_info": {
                    "vipType": 2,
                    "vipDueMsec": 0,
                    "vipStatus": 1
                },
                "trend_type": 0
            },
            {
                "mid": 53456,
                "pay_mid": 31345826,
                "rank": 3,
                "uname": "Aries梦落",
                "avatar": "http://i2.hdslb.com/bfs/face/206a58430c3e11675cacf3b7d7b4a8d9e44de3b2.jpg",
                "message": "",
                "msg_deleted": 0,
                "vip_info": {
                    "vipType": 2,
                    "vipDueMsec": 0,
                    "vipStatus": 1
                },
                "trend_type": 0
            },
            {
                "mid": 53456,
                "pay_mid": 349867059,
                "rank": 4,
                "uname": "铭月zsm",
                "avatar": "http://i0.hdslb.com/bfs/face/b8cd7533376d80a1d8b36092f433c39ba1761cbc.jpg",
                "message": "",
                "msg_deleted": 0,
                "vip_info": {
                    "vipType": 1,
                    "vipDueMsec": 0,
                    "vipStatus": 0
                },
                "trend_type": 0
            }
        ],
        "list": [
            {
                "mid": 53456,
                "pay_mid": 346545025,
                "rank": 1,
                "uname": "还有什么名字没人用",
                "avatar": "http://i1.hdslb.com/bfs/face/76d4b1ecd13e992a6c7303d77bf716dd922ab234.jpg",
                "message": "早日康复，五月快乐",
                "msg_deleted": 0,
                "vip_info": {
                    "vipType": 2,
                    "vipDueMsec": 0,
                    "vipStatus": 1
                },
                "trend_type": 0
            },
            {
                "mid": 53456,
                "pay_mid": 8826056,
                "rank": 2,
                "uname": "煋痕",
                "avatar": "http://i2.hdslb.com/bfs/face/35b7c752d0eb1bb7a924804f240b9bfd9199625f.jpg",
                "message": "",
                "msg_deleted": 0,
                "vip_info": {
                    "vipType": 2,
                    "vipDueMsec": 0,
                    "vipStatus": 1
                },
                "trend_type": 0
            },
            {
                "mid": 53456,
                "pay_mid": 356668487,
                "rank": 3,
                "uname": "舞象祥",
                "avatar": "http://i1.hdslb.com/bfs/face/574f6203ef5bd0d56b95ded6a2736676d9cc5307.jpg",
                "message": "warma  hayo",
                "msg_deleted": 0,
                "vip_info": {
                    "vipType": 1,
                    "vipDueMsec": 0,
                    "vipStatus": 1
                },
                "trend_type": 0
            },
            …………
        ]
    }
}