Skip to content

Latest commit

 

History

History
762 lines (644 loc) · 33.6 KB

info.md

File metadata and controls

762 lines (644 loc) · 33.6 KB
Raw

用户基本信息

用户空间详细信息

http://api.bilibili.com/x/space/acc/info

请求方式：GET

认证方式：Cookie(SESSDATA)

url参数：

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

json回复：

根对象：

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

data对象：

字段 类型 内容 备注
mid num mid
name str 昵称
sex str 性别 男/女/保密
face str 头像链接
sign str 签名
rank num 10000
level num 当前等级 0-6级
jointime num 0
moral num 0
silence num 封禁状态 0：正常
1：被封
coins num 硬币数 需要登录(Cookie)
只能查看自己的
默认为0
fans_badge bool 是否具有粉丝勋章 false：无
true：有
fans_medal obj
official obj 认证信息
vip obj 会员信息
pendant obj 头像框信息
nameplate obj 勋章信息
user_honour_info obj
is_followed bool 是否关注此用户 true：已关注
false：未关注
需要登录(Cookie)
未登录恒为false
top_photo str 主页头图链接
theme obj 空 作用尚不明确
sys_notice obj 系统通知 无内容则为空对象
主要用于展示如用户争议、纪念账号等等
live_room obj 直播间信息
birthday str 生日 MM-DD
如设置隐私为空
school obj 学校
profession obj
tags null
series obj

data中的official对象：

字段 类型 内容 备注
role num 认证类型 0：无
1 2 7：个人认证
3 4 5 6：机构认证
title str 认证信息 无为空
desc str 认证备注 无为空
type num 是否认证 -1：无
0：认证

data中的vip对象：

字段 类型 内容 备注
type num 会员类型 0：无
1：月大会员
2：年度及以上大会员
status num 会员状态 0：无
1：有
due_date num 会员过期时间 Unix时间戳(毫秒)
theme_type num 0 作用尚不明确
label obj 会员标签
avatar_subscript num 是否显示会员图标 0：不显示
1：显示
nickname_color str 会员昵称颜色 颜色码

vip中的label对象：

字段 类型 内容 备注
path str 空 作用尚不明确
text str 会员类型文案
label_theme str 会员标签 vip：大会员
annual_vip：年度大会员
ten_annual_vip：十年大会员
hundred_annual_vip：百年大会员

data中的pendant对象：

字段 类型 内容 备注
pid num 头像框id 详细说明有待补充
name str 头像框名称
image str 头像框图片url
expire num 0 作用尚不明确

data中的nameplate对象：

字段 类型 内容 备注
nid num 勋章id 详细说明有待补充
name str 勋章名称
image str 挂件图片url 正常
image_small str 勋章图片url 小
level str 勋章等级
condition str 勋章条件

data中的sys_notice对象：

字段 类型 内容 备注
id num 系统提示类型id 8：争议账号
20：纪念账号
22：合约诉讼
content str 提示文案
url str 提示信息页面url
notice_type num ？ 作用尚不明确
此字段非必须
icon str 提示图标url 此字段非必须
text_color str 提示文字颜色 此字段非必须
颜色码
bg_color str 提示背景颜色 此字段非必须
颜色码

data中的school对象：

字段 类型 内容 备注
name str 就读大学名称 没有则为空

data中的live_room对象：

字段 类型 内容 备注
roomStatus num 直播间状态 0：无房间
1：有房间
liveStatus num 直播状态 0：未开播
1：直播中
url str 直播间网页url
title str 直播间标题
cover str 直播间封面url
online num 直播间人气 值为上次直播时刷新
roomid num 直播间id(短号)
roundStatus num 轮播状态 0：未轮播
1：轮播
broadcast_type num 0

示例：

查询用户mid=2的详细信息

curl -G 'http://api.bilibili.com/x/space/acc/info' \
--data-urlencode 'mid=2' \
-b 'SESSDATA=xxx'
查看响应示例： 
{
    "code": 0,
    "message": "0",
    "ttl": 1,
    "data": {
        "mid": 2,
        "name": "碧诗",
        "sex": "男",
        "face": "http://i2.hdslb.com/bfs/face/ef0457addb24141e15dfac6fbf45293ccf1e32ab.jpg",
        "sign": "kami.im 直男过气网红 # av362830 “We Are Star Dust”",
        "rank": 20000,
        "level": 6,
        "jointime": 0,
        "moral": 0,
        "silence": 0,
        "coins": 0,
        "fans_badge": true,
        "fans_medal": {
            "show": true,
            "wear": true,
            "medal": {
                "uid": 2,
                "target_id": 335115,
                "medal_id": 45408,
                "level": 21,
                "medal_name": "伍千万",
                "medal_color": 1725515,
                "intimacy": 1980,
                "next_intimacy": 2000,
                "day_limit": 250000,
                "medal_color_start": 1725515,
                "medal_color_end": 5414290,
                "medal_color_border": 1725515,
                "is_lighted": 1,
                "light_status": 1,
                "wearing_status": 1,
                "score": 50001980
            }
        },
        "official": {
            "role": 2,
            "title": "bilibili创始人（站长）",
            "desc": "",
            "type": 0
        },
        "vip": {
            "type": 2,
            "status": 1,
            "due_date": 3896524800000,
            "vip_pay_type": 0,
            "theme_type": 0,
            "label": {
                "path": "",
                "text": "十年大会员",
                "label_theme": "ten_annual_vip",
                "text_color": "#FFFFFF",
                "bg_style": 1,
                "bg_color": "#FB7299",
                "border_color": ""
            },
            "avatar_subscript": 1,
            "nickname_color": "#FB7299",
            "role": 7,
            "avatar_subscript_url": "http://i0.hdslb.com/bfs/vip/icon_Certification_big_member_22_3x.png"
        },
        "pendant": {
            "pid": 0,
            "name": "",
            "image": "",
            "expire": 0,
            "image_enhance": "",
            "image_enhance_frame": ""
        },
        "nameplate": {
            "nid": 10,
            "name": "见习偶像",
            "image": "http://i0.hdslb.com/bfs/face/e93dd9edfa7b9e18bf46fd8d71862327a2350923.png",
            "image_small": "http://i1.hdslb.com/bfs/face/275b468b043ec246737ab8580a2075bee0b1263b.png",
            "level": "普通勋章",
            "condition": "所有自制视频总播放数\u003e=10万"
        },
        "user_honour_info": {
            "mid": 0,
            "colour": null,
            "tags": null
        },
        "is_followed": true,
        "top_photo": "http://i0.hdslb.com/bfs/space/cb1c3ef50e22b6096fde67febe863494caefebad.png",
        "theme": {},
        "sys_notice": {},
        "live_room": {
            "roomStatus": 1,
            "liveStatus": 0,
            "url": "https://live.bilibili.com/1024",
            "title": "试图恰鸡",
            "cover": "http://i0.hdslb.com/bfs/live/new_room_cover/96ee5bfd0279a0f18b190340334f43f473038288.jpg",
            "online": 16808,
            "roomid": 1024,
            "roundStatus": 0,
            "broadcast_type": 0
        },
        "birthday": "09-19",
        "school": {
            "name": ""
        },
        "profession": {
            "name": ""
        },
        "tags": null,
        "series": {
            "user_upgrade_status": 1,
            "show_upgrade_window": false
        }
    }
}

查询到的信息解析如下：

用户昵称为：碧诗

性别：男

用户的头像为：

http://i1.hdslb.com/bfs/face/3e60b20604b6fdc7d081eb6a1ec72aa47c5a3964.jpg

等级：6级

生日：09-19

粉丝勋章状态：拥有

认证：个人认证

认证名称： bilibili创始人(站长)

大会员类型：年度

大会员状态：已开通

头像框：管理员

http://i2.hdslb.com/bfs/face/02a3b79edef0f0e682de7f5dca7b6b5fe36d5f65.png

粉丝勋章： 见习偶像

http://i1.hdslb.com/bfs/face/e93dd9edfa7b9e18bf46fd8d71862327a2350923.png

空间头图：

http://i2.hdslb.com/bfs/space/cb1c3ef50e22b6096fde67febe863494caefebad.png

用户名片信息

http://api.bilibili.com/x/web-interface/card

请求方式：GET

认证方式：Cookie(SESSDATA)

url参数：

参数名 类型 内容 必要性 备注
mid num 目标用户mid 必要
photo bool 是否请求用户主页头图 非必要 true：是
false：否

json回复：

根对象：

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

data对象：

字段 类型 内容 备注
card obj 卡片信息

data中的card对象：

字段 类型 内容 备注
mid num 用户mid
approve bool false 作用尚不明确
name str 用户昵称
sex str 用户性别 男 女 保密
face str 用户头像链接
DisplayRank str 0 作用尚不明确
regtime num 0 作用尚不明确
spacesta num 0 作用尚不明确
birthday str 空 作用尚不明确
place str 空 作用尚不明确
description str 空 作用尚不明确
article num 0 作用尚不明确
attentions array 空 作用尚不明确
fans num 粉丝数
friend num 关注数
attention num 关注数
level_info obj 等级
pendant obj 挂件
nameplate obj 勋章
Official obj 认证信息
official_verify obj 认证信息2
vip obj 大会员状态
space obj 主页头图
following bool 是否关注此用户 true：已关注
false：未关注
需要登录(Cookie)
未登录为false
archive_count num 用户稿件数
article_count num 0 作用尚不明确
follower num 粉丝数

card中的level_info对象：

字段 类型 内容 备注
current_level num 当前等级 0-6级
current_min num 0 作用尚不明确
current_exp num 0 作用尚不明确
next_exp num 0 作用尚不明确

card中的pendant对象：

字段 类型 内容 备注
pid num 挂件id
name str 挂件名称
image str 挂件图片url
expire num 0 作用尚不明确

card中的nameplate对象：

字段 类型 内容 备注
nid num 勋章id 详细说明有待补充
name str 勋章名称
image str 挂件图片url 正常
image_small str 勋章图片url 小
level str 勋章等级
condition str 勋章条件

card中的Official对象：

字段 类型 内容 备注
role num 认证类型 0：无
1 2 7：个人认证
3 4 5 6：机构认证
title str 认证信息 无为空
desc str 认证备注 无为空
type num 是否认证 -1：无
0：认证

card中的official_verify对象：

字段 类型 内容 备注
type num 是否认证 -1：无
0：认证
desc str 认证信息 无为空

card中的vip对象：

字段 类型 内容 备注
vipType num 大会员类型 0：无
1：月度大会员
2：年度及以上大会员
dueRemark str 空 作用尚不明确
accessStatus num 0 作用尚不明确
vipStatus num 大会员状态 0：无
1：有
vipStatusWarn str 空 作用尚不明确
theme_type num 0 作用尚不明确

card中的space对象：

字段 类型 内容 备注
s_img str 主页头图url 小图
l_img str 主页头图url 正常

示列：

curl -G 'api.bilibili.com/x/web-interface/card' \
--data-urlencode 'mid=2' \
--data-urlencode 'photo=true' \
-b 'SESSDATA=xxx'
查看响应示例： 
{
    "code": 0,
    "message": "0",
    "ttl": 1,
    "data": {
        "card": {
            "mid": "2",
            "name": "碧诗",
            "approve": false,
            "sex": "男",
            "rank": "20000",
            "face": "http://i2.hdslb.com/bfs/face/ef0457addb24141e15dfac6fbf45293ccf1e32ab.jpg",
            "DisplayRank": "0",
            "regtime": 0,
            "spacesta": 0,
            "birthday": "",
            "place": "",
            "description": "",
            "article": 0,
            "attentions": [],
            "fans": 969999,
            "friend": 234,
            "attention": 234,
            "sign": "kami.im 直男过气网红 # av362830 “We Are Star Dust”",
            "level_info": {
                "current_level": 6,
                "current_min": 0,
                "current_exp": 0,
                "next_exp": 0
            },
            "pendant": {
                "pid": 0,
                "name": "",
                "image": "",
                "expire": 0,
                "image_enhance": "",
                "image_enhance_frame": ""
            },
            "nameplate": {
                "nid": 10,
                "name": "见习偶像",
                "image": "http://i2.hdslb.com/bfs/face/e93dd9edfa7b9e18bf46fd8d71862327a2350923.png",
                "image_small": "http://i2.hdslb.com/bfs/face/275b468b043ec246737ab8580a2075bee0b1263b.png",
                "level": "普通勋章",
                "condition": "所有自制视频总播放数\u003e=10万"
            },
            "Official": {
                "role": 2,
                "title": "bilibili创始人（站长）",
                "desc": "",
                "type": 0
            },
            "official_verify": {
                "type": 0,
                "desc": "bilibili创始人（站长）"
            },
            "vip": {
                "type": 2,
                "status": 1,
                "due_date": 3896524800000,
                "vip_pay_type": 0,
                "theme_type": 0,
                "label": {
                    "path": "",
                    "text": "十年大会员",
                    "label_theme": "ten_annual_vip",
                    "text_color": "#FFFFFF",
                    "bg_style": 1,
                    "bg_color": "#FB7299",
                    "border_color": ""
                },
                "avatar_subscript": 1,
                "nickname_color": "#FB7299",
                "role": 7,
                "avatar_subscript_url": "http://i0.hdslb.com/bfs/vip/icon_Certification_big_member_22_3x.png",
                "vipType": 2,
                "vipStatus": 1
            }
        },
        "space": {
            "s_img": "http://i1.hdslb.com/bfs/space/768cc4fd97618cf589d23c2711a1d1a729f42235.png",
            "l_img": "http://i1.hdslb.com/bfs/space/cb1c3ef50e22b6096fde67febe863494caefebad.png"
        },
        "following": true,
        "archive_count": 37,
        "article_count": 0,
        "follower": 969999
    }
}

登录用户空间详细信息

http://api.bilibili.com/x/space/myinfo

请求方式：GET

认证方式：Cookie(SESSDATA)

json回复：

根对象：

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

data对象：

字段 类型 内容 备注
mid num mid
name str 昵称
sex str 性别 男 女 保密
face str 头像图片url
sign str 签名
rank num 10000 作用尚不明确
level num 当前等级 0-6级
jointime num 0 作用尚不明确
moral num 节操 默认70
silence num 封禁状态 0：正常
1：被封
email_status num 已验证邮箱 0：未验证
1：已验证
tel_status num 已验证手机号 0：未验证
1：已验证
identification num 1 作用尚不明确
vip obj 大会员状态
birthday num 生日 时间戳
is_tourist num 0 作用尚不明确
is_fake_account num 0 作用尚不明确
pin_prompting num 0 作用尚不明确
is_deleted num 0 作用尚不明确
coins num 硬币数
following num 粉丝数
follower num 粉丝数

data中的vip对象：

字段 类型 内容 备注
type num 会员类型 0：无
1：月大会员
2：年度及以上大会员
status num 会员状态 0：无
1：有
due_date num 会员过期时间 Unix时间戳(毫秒)
theme_type num 0 作用尚不明确
label obj 会员标签
avatar_subscript num 是否显示会员图标 0：不显示
1：显示
nickname_color str 会员昵称颜色 颜色码

vip中的label对象：

字段 类型 内容 备注
path str 空 作用尚不明确
text str 会员名称
label_theme str 会员标签 vip：大会员
annual_vip：年度大会员
ten_annual_vip：十年大会员
hundred_annual_vip：百年大会员

data中的pendant对象：

字段 类型 内容 备注
pid num 挂件id 详细说明有待补充
name str 挂件名称
image str 挂件图片url
expire num 0 作用尚不明确

data中的nameplate对象：

字段 类型 内容 备注
nid num 勋章id 详细说明有待补充
name str 勋章名称
image str 挂件图片url 正常
image_small str 勋章图片url 小
level str 勋章等级
condition str 勋章条件

data中的Official对象：

字段 类型 内容 备注
role num 认证类型 0：无
1 2 7：个人认证
3 4 5 6：机构认证
title str 认证信息 无为空
desc str 认证备注 无为空
type num 是否认证 -1：无
0：认证

data中的level_exp对象：

字段 类型 内容 备注
current_level num 当前等级 0-6级
current_min num 0 指当前等级从多少经验值开始
current_exp num 0 当前账户的经验值
next_exp num 0 下一个等级所需的经验值**(不是还需要多少)**

示例：

curl -G 'api.bilibili.com/x/space/myinfo' \
-b 'SESSDATA=xxx'
查看响应示例： 
{
    "code": 0,
    "message": "0",
    "ttl": 1,
    "data": {
        "mid": 293793435,
        "name": "社会易姐QwQ",
        "sex": "男",
        "face": "http://i0.hdslb.com/bfs/face/aebb2639a0d47f2ce1fec0631f412eaf53d4a0be.jpg",
        "sign": "高考刚结束的普通技术宅一枚，喜欢MC和编程以及电子，是车车人也是术术人，粉丝群:1136462265",
        "rank": 10000,
        "level": 5,
        "jointime": 0,
        "moral": 70,
        "silence": 0,
        "email_status": 1,
        "tel_status": 1,
        "identification": 1,
        "vip": {
            "type": 2,
            "status": 1,
            "due_date": 1644163200000,
            "vip_pay_type": 0,
            "theme_type": 0,
            "label": {
                "path": "",
                "text": "年度大会员",
                "label_theme": "annual_vip",
                "text_color": "#FFFFFF",
                "bg_style": 1,
                "bg_color": "#FB7299",
                "border_color": ""
            },
            "avatar_subscript": 1,
            "nickname_color": "#FB7299",
            "role": 3,
            "avatar_subscript_url": "http://i0.hdslb.com/bfs/vip/icon_Certification_big_member_22_3x.png"
        },
        "pendant": {
            "pid": 2511,
            "name": "初音未来13周年",
            "image": "http://i0.hdslb.com/bfs/garb/item/4f8f3f1f2d47f0dad84f66aa57acd4409ea46361.png",
            "expire": 0,
            "image_enhance": "http://i0.hdslb.com/bfs/garb/item/fe0b83b53e2342b16646f6e7a9370d8a867decdb.webp",
            "image_enhance_frame": "http://i0.hdslb.com/bfs/garb/item/127c507ec8448be30cf5f79500ecc6ef2fd32f2c.png"
        },
        "nameplate": {
            "nid": 4,
            "name": "青铜殿堂",
            "image": "http://i0.hdslb.com/bfs/face/2879cd5fb8518f7c6da75887994c1b2a7fe670bd.png",
            "image_small": "http://i0.hdslb.com/bfs/face/6707c120e00a3445933308fd9b7bd9fad99e9ec4.png",
            "level": "普通勋章",
            "condition": "单个自制视频总播放数\u003e=1万"
        },
        "official": {
            "role": 0,
            "title": "",
            "desc": "",
            "type": -1
        },
        "birthday": 1015257600,
        "is_tourist": 0,
        "is_fake_account": 0,
        "pin_prompting": 0,
        "is_deleted": 0,
        "in_reg_audit": 0,
        "is_rip_user": false,
        "profession": {
            "id": 0,
            "name": "",
            "show_name": ""
        },
        "level_exp": {
            "current_level": 5,
            "current_min": 10800,
            "current_exp": 27125,
            "next_exp": 28800
        },
        "coins": 9,
        "following": 1122,
        "follower": 1122
    }
}