Skip to content

Latest commit

 

History

History
249 lines (211 loc) · 10.7 KB

info.md

File metadata and controls

249 lines (211 loc) · 10.7 KB
Raw

相簿基本信息

获取相簿详细信息

http://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 'http://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
        }
    }
}