Skip to content

Latest commit

 

History

History
245 lines (209 loc) · 10.6 KB

info.md

File metadata and controls

245 lines (209 loc) · 10.6 KB

相簿基本信息

获取相簿详细信息

https://api.vc.bilibili.com/link_draw/v1/doc/detail

请求方式:GET

认证方式:Cookie(SESSDSTA)

url参数:

参数名 类型 内容 必要性 备注
doc_id num 目标相簿id 必要

json回复:

根对象:

字段 类型 内容 备注
code num 返回值 0:成功
110001:找不到目标相簿
msg str 错误信息 默认为success
message str 错误信息 默认为success
data obj 信息本体

data对象:

字段 类型 内容 备注
user obj 作者信息
item obj 相簿信息

data中的user对象:

字段 类型 内容 备注
uid num 作者mid
head_url str 头像url
name str 昵称
vip obj 会员信息
upload_count str 相簿投稿数

user中的vip对象:

字段 类型 内容 备注
vipType num 会员类型 0:无
1:月度大会员
2:年度及以上大会员
vipDueDate num 会员到期时间 毫秒 时间戳
dueRemark str 作用尚不明确
accessStatus num 0 作用尚不明确
vipStatus num 会员开通状态 0:无
1:有
vipStatusWarn str 作用尚不明确
themeType num 0 作用尚不明确
label obj 作用尚不明确

vip中的label对象:

字段 类型 内容 备注
path str 作用尚不明确

data中的item对象:

字段 类型 内容 备注
biz num 相簿分区 1:画友
2:摄影
3:日常
doc_id num 相簿id
poster_uid num 作者mid
category str 子分区标识 cos:cosplay
daily:日常
illustration:插画
comic:漫画
draw:其他
sifu:私服
type num 相簿类型 0:原创
1:同人
title str 标题
tags array 相簿TAG
pictures array 相簿图片
source null 作用尚不明确
upload_time str 投稿时间(时间码) YYYY-MM-DD hh:mm:ss
upload_timestamp num 投稿时间(时间戳)
upload_time_text str 投稿时间(文本)
description str 简介
role null 作用尚不明确
settings obj 权限配置
already_collected num 是否已收藏 需要登录(Cookie)
否则恒为0
already_liked num 0 作用尚不明确
user_status num 0 作用尚不明确
at_control str 作用尚不明确
view_count num 观看数
like_count num 0 作用尚不明确
collect_count num 收藏数
verify_status num 1 作用尚不明确
already_voted num 是否已点赞 需要登录(Cookie)
否则恒为0
vote_count num 点赞数
comment_count num 评论数

item中的tags数组:

类型 内容 备注
0 obj TAG 1
n obj TAG (n+1)
…… obj …… ……

item中的tags数组中的对象:

字段 类型 内容 备注
tag str TAG名
type num 类型?
category str TAG所属子分区名
link str 活动页面url 是活动TAG有此项
text str TAG名
name str TAG名

item中的pictures数组:

类型 内容 备注
0 obj 图片 1
n obj 图片 (n+1)
…… obj …… ……

item中的pictures数组中的对象:

字段 类型 内容 备注
img_src str 图片url
img_width num 图片宽度
img_height num 图片高度
img_size num 图片大小 单位为KByte

item中的settings对象:

字段 类型 内容 备注
copy_forbidden num 禁止转载标志 0:不设置转载权限
1:开放授权-署名-非商用转载
2:作者授权-署名-非商用转载
3:禁止转载

示例:

查询相簿id=99184721的详细信息

curl -G 'https://api.vc.bilibili.com/link_draw/v1/doc/detail' \
--data-urlencode 'doc_id=99184721' \
-b 'SESSDATA=xxx'
查看响应示例:
{
    "code": 0,
    "msg": "success",
    "message": "success",
    "data": {
        "user": {
            "uid": 813818,
            "head_url": "https://i2.hdslb.com/bfs/face/26b12390399f3e82fb913922938f8a6662d28665.jpg",
            "name": "QYS3",
            "vip": {
                "vipType": 2,
                "vipDueDate": 1613750400000,
                "dueRemark": "",
                "accessStatus": 0,
                "vipStatus": 1,
                "vipStatusWarn": "",
                "themeType": 0,
                "label": {
                    "path": ""
                }
            },
            "upload_count": "171"
        },
        "item": {
            "biz": 1,
            "doc_id": 99184721,
            "poster_uid": 813818,
            "category": "illustration",
            "type": 1,
            "title": "旅行",
            "tags": [
                {
                    "tag": "魔女之旅",
                    "type": 4,
                    "category": "illustration",
                    "text": "魔女之旅",
                    "name": "魔女之旅"
                },
                {
                    "tag": "伊蕾娜",
                    "type": 3,
                    "category": "illustration",
                    "text": "伊蕾娜",
                    "name": "伊蕾娜"
                },
                {
                    "tag": "旅行",
                    "type": 3,
                    "category": "illustration",
                    "text": "旅行",
                    "name": "旅行"
                },
                {
                    "tag": "魔女",
                    "type": 3,
                    "category": "illustration",
                    "text": "魔女",
                    "name": "魔女"
                }
            ],
            "pictures": [
                {
                    "img_src": "https://i0.hdslb.com/bfs/album/d531e3dae34ef65b44ecdb2914d4cc4f5a4da998.jpg",
                    "img_width": 1236,
                    "img_height": 1600,
                    "img_size": 508
                }
            ],
            "source": null,
            "upload_time": "2020-11-23 23:03:12",
            "upload_timestamp": 1606143792,
            "upload_time_text": "3天前",
            "description": "伊蕾娜世界第一~!",
            "role": null,
            "settings": {
                "copy_forbidden": 0
            },
            "already_collected": 0,
            "already_liked": 0,
            "user_status": 0,
            "at_control": "",
            "view_count": 143699,
            "like_count": 0,
            "collect_count": 54,
            "verify_status": 1,
            "already_voted": 0,
            "vote_count": 2258,
            "comment_count": 98
        }
    }
}