import{_ as e,c,a as o,b as n,d as a,e as t,w as p,r as D,o as r}from"./app-Dgsdh8A6.js";const i={};function d(u,s){const l=D("RouteLink");return r(),c("div",null,[s[19]||(s[19]=o('

卡片信息

获取专栏显示卡片信息

https://api.bilibili.com/x/article/cards

请求方法: GET

鉴权方式: 请求头 Referer 在 .bilibili.com 下

URL 参数:

',6)),n("table",null,[s[14]||(s[14]=n("thead",null,[n("tr",null,[n("th",null,"参数"),n("th",null,"类型"),n("th",null,"内容"),n("th",null,"必要性"),n("th",null,"备注")])],-1)),n("tbody",null,[s[12]||(s[12]=n("tr",null,[n("td",null,"ids"),n("td",null,"string"),n("td",null,"被查询的 id 列表"),n("td",null,"不必要"),n("td",null,[a("以 "),n("code",null,","),a(" 分隔, 可填视频完整 AV/BV 号, 专栏 CV 号, 直播间长短 lv 号 (可能会合并同类项)")])],-1)),s[13]||(s[13]=n("tr",null,[n("td",null,"web_location"),n("td",null,"string"),n("td",null,[n("code",null,"333.1305")]),n("td",null,"不必要"),n("td")],-1)),n("tr",null,[s[2]||(s[2]=n("td",null,"w_rid",-1)),s[3]||(s[3]=n("td",null,"string",-1)),s[4]||(s[4]=n("td",null,"WBI 签名",-1)),s[5]||(s[5]=n("td",null,"不必要",-1)),n("td",null,[s[1]||(s[1]=a("参见 ")),t(l,{to:"/docs/misc/sign/wbi.html"},{default:p(()=>s[0]||(s[0]=[a("WBI 签名")])),_:1,__:[0]})])]),n("tr",null,[s[8]||(s[8]=n("td",null,"wts",-1)),s[9]||(s[9]=n("td",null,"number",-1)),s[10]||(s[10]=n("td",null,"UNIX 秒级时间戳",-1)),s[11]||(s[11]=n("td",null,"不必要",-1)),n("td",null,[s[7]||(s[7]=a("参见 ")),t(l,{to:"/docs/misc/sign/wbi.html"},{default:p(()=>s[6]||(s[6]=[a("WBI 签名")])),_:1,__:[6]})])])])]),s[20]||(s[20]=o("

JSON 回复:

根对象:

字段类型内容备注
codenumber返回值0: 成功
dataobject数据本体
messagestring错误信息成功时为 0
ttlnumber1

data 对象:

以请求时 ids 字段中每一项为键, 其内容对象为值的表, 注意可能会合并同类项

data 中代表视频的对象 (avxxx 或 Bvxxxxxxxxxx):

详细可参见 [视频基本信息] (../video/info.md)

字段类型内容备注
aidnumber
bvidstring
cidnumber
copyrightnumber
cover43string
ctimenumber
descstring
dimensionobject
durationnumber
dynamicstring
ownerobject
picstring
pubdatenumber
rightsobject
short_link_v2string
statobject
statenumber
tidnumber
titlestring
tnamestring
videosnumber
vt_switchboolean

data 中代表专栏的对象 (cvxxx):

",9)),n("p",null,[s[16]||(s[16]=a("详细可参见 ")),t(l,{to:"/docs/article/view.html"},{default:p(()=>s[15]||(s[15]=[a("专栏内容")])),_:1,__:[15]})]),s[21]||(s[21]=o("
字段类型内容备注
act_idnumber
apply_timestring
attributesnumber
authenMarknull
authorobject
banner_urlstring
categoriesobject[]
categoryobject
check_statenumber
check_timestring
content_pic_listnull
cover_avidnumber
ctimenumber
disputenull
dynamicstring
idnumber
image_urlsstring[]
is_likeboolean
listobject
mediaobject
mtimenumber
origin_image_urlsstring[]
origin_template_idnumber
originalnumber
private_pubnumber
publish_timenumber
reprintnumber
statenumber
statsobject
summarystring
template_idnumber
titlestring
top_video_infonull
typenumber
wordsnumber

data 中代表直播间的对象:

",2)),n("p",null,[s[18]||(s[18]=a("详细可参见 ")),t(l,{to:"/docs/live/info.html"},{default:p(()=>s[17]||(s[17]=[a("直播间基本信息")])),_:1,__:[17]})]),s[22]||(s[22]=o(`
字段类型内容备注
area_v2_namestring分区完整名称
coverstring直播封面
facestring主播头像
live_statusnumber直播状态
onlinenumber在线人数
pendent_rustring
pendent_ru_colorstring
pendent_ru_picstring
rolenumber
room_idnumber直播间长 id
titlestring直播间标题
uidnumber主播 UID (mid)
unamestring主播用户名

示例:

curl 'https://api.bilibili.com/x/article/cards?ids=av2,cv1,cv2,15111509,lv1,lv5440' \\
  --referer 'https://www.bilibili.com/'
查看响应示例:
{
  "code": 0,
  "data": {
    "av2": {
      "aid": 2,
      "bvid": "BV1xx411c7mD",
      "cid": 62131,
      "copyright": 2,
      "cover43": "",
      "ctime": 1497344798,
      "desc": "www",
      "dimension": {
        "height": 360,
        "rotate": 0,
        "width": 480
      },
      "duration": 2055,
      "dynamic": "",
      "owner": {
        "face": "https://i2.hdslb.com/bfs/face/ef0457addb24141e15dfac6fbf45293ccf1e32ab.jpg",
        "mid": 2,
        "name": "碧诗"
      },
      "pic": "http://static.hdslb.com/images/transparent.gif",
      "pubdate": 1252458549,
      "rights": {
        "arc_pay": 0,
        "autoplay": 1,
        "bp": 0,
        "download": 0,
        "elec": 0,
        "hd5": 0,
        "is_cooperation": 0,
        "movie": 0,
        "no_background": 0,
        "no_reprint": 0,
        "pay": 0,
        "pay_free_watch": 0,
        "ugc_pay": 0,
        "ugc_pay_preview": 0
      },
      "short_link_v2": "https://b23.tv/BV1xx411c7mD",
      "stat": {
        "aid": 2,
        "coin": 38042,
        "danmaku": 121342,
        "dislike": 0,
        "favorite": 107375,
        "his_rank": 0,
        "like": 261036,
        "now_rank": 0,
        "reply": 86021,
        "share": 20052,
        "view": 4983587,
        "vt": 0,
        "vv": 0
      },
      "state": 0,
      "tid": 130,
      "title": "字幕君交流场所",
      "tname": "音乐综合",
      "videos": 1,
      "vt_switch": false
    },
    "cv1": {
      "act_id": 0,
      "apply_time": "",
      "attributes": 24,
      "authenMark": null,
      "author": {
        "face": "https://i1.hdslb.com/bfs/face/89fe260a17891fdadc3365a9698fee52796c7765.jpg",
        "fans": 0,
        "level": 0,
        "mid": 91221505,
        "name": "健行见远渐忘",
        "nameplate": {
          "condition": "2018.6.26-7.8某一天是年度大会员",
          "image": "https://i2.hdslb.com/bfs/face/421179426c929dfeaed4117461c83f5d07ffb148.png",
          "image_small": "https://i1.hdslb.com/bfs/face/682001c2e1c2ae887bdf2a0e18eef61180c48f84.png",
          "level": "稀有勋章",
          "name": "大会员2018年度勋章",
          "nid": 74
        },
        "official_verify": {
          "desc": "",
          "type": -1
        },
        "pendant": {
          "expire": 0,
          "image": "https://i1.hdslb.com/bfs/face/7ae15f06f8c912435206a2578509d6bc77c12353.png",
          "name": "作文鬼才",
          "pid": 255
        },
        "vip": {
          "avatar_subscript": 1,
          "due_date": 0,
          "label": {
            "label_theme": "annual_vip",
            "path": "http://i0.hdslb.com/bfs/vip/label_annual.png",
            "text": "年度大会员"
          },
          "nickname_color": "#FB7299",
          "status": 1,
          "theme_type": 0,
          "type": 2,
          "vip_pay_type": 0
        }
      },
      "banner_url": "https://i0.hdslb.com/bfs/article/b1e1029c08d8ad1bb06460d736839a7741dd7925.jpg",
      "categories": [
        {
          "id": 3,
          "name": "生活",
          "parent_id": 0
        },
        {
          "id": 15,
          "name": "日常",
          "parent_id": 3
        }
      ],
      "category": {
        "id": 15,
        "name": "日常",
        "parent_id": 3
      },
      "check_state": 0,
      "check_time": "",
      "content_pic_list": null,
      "cover_avid": 0,
      "ctime": 1497973729,
      "dispute": null,
      "dynamic": "It's now or never !",
      "id": 1,
      "image_urls": [
        "https://i0.hdslb.com/bfs/article/d2eedf1fd338bceca10099e2f7b33fa9017c859b.jpg"
      ],
      "is_like": false,
      "list": {
        "apply_time": "",
        "articles_count": 0,
        "check_time": "",
        "ctime": 1588601669,
        "id": 253534,
        "image_url": "",
        "mid": 91221505,
        "name": "静夜思",
        "publish_time": 1625900652,
        "read": 0,
        "reason": "",
        "state": 1,
        "summary": "",
        "update_time": 1625900518,
        "words": 3059
      },
      "media": {
        "area": "",
        "cover": "",
        "media_id": 0,
        "score": 0,
        "season_id": 0,
        "spoiler": 0,
        "title": "",
        "type_id": 0,
        "type_name": ""
      },
      "mtime": 1589209079,
      "origin_image_urls": [
        "https://i0.hdslb.com/bfs/article/b1e1029c08d8ad1bb06460d736839a7741dd7925.jpg"
      ],
      "origin_template_id": 4,
      "original": 0,
      "private_pub": 0,
      "publish_time": 1519913233,
      "reprint": 0,
      "state": 0,
      "stats": {
        "coin": 2545,
        "dislike": 1,
        "dynamic": 0,
        "favorite": 17524,
        "like": 32489,
        "reply": 14399,
        "share": 616,
        "view": 1631442
      },
      "summary": "天空像是倾倒出的墨水，黑得静谧而深邃。黎明还远，光亮全无。夜不能寐。披衣，起床。茶香的弥漫，一盏灯的相伴。夜，你是我久别重逢的朋友，那一刹那的相见，带给了我久违的安思。如果不是梦魇的皮闹，我本不该投入",
      "template_id": 4,
      "title": "未知的光",
      "top_video_info": null,
      "type": 0,
      "words": 1190
    },
    "cv2": {
      "act_id": 0,
      "apply_time": "",
      "authenMark": null,
      "author": {
        "face": "http://i0.hdslb.com/bfs/face/ff6b51c3b339dae5f341d1693f52132ab11c86b6.jpg",
        "fans": 0,
        "level": 0,
        "mid": 144900660,
        "name": "专栏小天使",
        "nameplate": {
          "condition": "",
          "image": "",
          "image_small": "",
          "level": "",
          "name": "",
          "nid": 0
        },
        "official_verify": {
          "desc": "专栏小天使 官方账号",
          "type": 0
        },
        "pendant": {
          "expire": 0,
          "image": "",
          "name": "",
          "pid": 0
        },
        "vip": {
          "avatar_subscript": 0,
          "due_date": 0,
          "label": {
            "label_theme": "",
            "path": "",
            "text": ""
          },
          "nickname_color": "",
          "status": 0,
          "theme_type": 0,
          "type": 0,
          "vip_pay_type": 0
        }
      },
      "banner_url": "https://i0.hdslb.com/bfs/article/131b1d41b857d5308f5bff36591d117bddc48d96.jpg@90p.webp",
      "categories": [
        {
          "id": 3,
          "name": "生活",
          "parent_id": 0
        },
        {
          "id": 15,
          "name": "日常",
          "parent_id": 3
        }
      ],
      "category": {
        "id": 15,
        "name": "日常",
        "parent_id": 3
      },
      "check_state": 0,
      "check_time": "",
      "content_pic_list": null,
      "cover_avid": 0,
      "ctime": 1497973871,
      "dispute": null,
      "id": 2,
      "image_urls": [
        "https://i0.hdslb.com/bfs/article/0a72422ce8e77d8512f010d93b1b7f9bc4e64e52.jpg"
      ],
      "is_like": false,
      "list": null,
      "media": {
        "area": "",
        "cover": "",
        "media_id": 0,
        "score": 0,
        "season_id": 0,
        "spoiler": 0,
        "title": "",
        "type_id": 0,
        "type_name": ""
      },
      "mtime": 1640696950,
      "origin_image_urls": [
        "https://i0.hdslb.com/bfs/article/131b1d41b857d5308f5bff36591d117bddc48d96.jpg"
      ],
      "origin_template_id": 4,
      "original": 0,
      "private_pub": 0,
      "publish_time": 1509517123,
      "reprint": 1,
      "state": 0,
      "stats": {
        "coin": 3590,
        "dislike": 0,
        "dynamic": 0,
        "favorite": 5614,
        "like": 16956,
        "reply": 1944,
        "share": 371,
        "view": 1184187
      },
      "summary": "欢迎各位使用Bilibili专栏，为了保证Bilibili专栏的内容质量，维护专栏的内容生态，让创作者和读者都拥有良好的使用体验和阅读体验，请各位谨遵以下规范条例：\\n\\n严令禁止条例\\nbilibili严",
      "template_id": 4,
      "title": "专栏行为准则  ",
      "top_video_info": null,
      "type": 0,
      "words": 3711
    },
    "lv5440": {
      "area_v2_name": "历史·人文·综合",
      "cover": "https://i0.hdslb.com/bfs/live/9fe50921ab9b49e80dcb398f65135191d1b8252c.jpg",
      "face": "https://i0.hdslb.com/bfs/face/8f6a614a48a3813d90da7a11894ae56a59396fcd.jpg",
      "live_status": 2,
      "online": 0,
      "pendent_ru": "",
      "pendent_ru_color": "",
      "pendent_ru_pic": "",
      "role": 0,
      "room_id": 5440,
      "title": "一场穿越20年的直播｜梦回千禧文学",
      "uid": 9617619,
      "uname": "哔哩哔哩直播"
    }
  },
  "message": "0",
  "ttl": 1
}
`,4))])}const C=e(i,[["render",d]]),v=JSON.parse('{"path":"/docs/article/card.html","title":"卡片信息","lang":"zh-CN","frontmatter":{},"git":{"updatedTime":1745658266000,"contributors":[{"name":"SessionHu","username":"SessionHu","email":"102411014+SessionHu@users.noreply.github.com","commits":1,"url":"https://github.com/SessionHu"}],"changelog":[{"hash":"8ed1756622d89ed1ba912cb50f57554193b6a60e","time":1745658266000,"email":"102411014+SessionHu@users.noreply.github.com","author":"SessionHu","message":"feat: 专栏显示卡片信息"}]},"filePathRelative":"docs/article/card.md"}');export{C as comp,v as data};