返回提交历史
Modified
user/relation.md
+180
-0
XFEstudio/bilibili-API-collect
添加另一个获取用户关注列表的API (#521)
* Update info.md * Update relation.md * Update relation.md
6c84413
代码差异
1 个文件
+180
-0
@@ -2,6 +2,7 @@
2
2
3
3
- [查询用户粉丝明细](#查询用户粉丝明细)
4
4
- [查询用户关注明细](#查询用户关注明细)
5
- [查询用户关注明细2](#查询用户关注明细2)
5
6
- [搜索关注明细](#搜索关注明细)
6
7
- [查询共同关注明细](#查询共同关注明细)
7
8
- [查询悄悄关注明细](#查询悄悄关注明细)
@@ -373,6 +374,185 @@ curl -G 'https://api.bilibili.com/x/relation/followings' \
373
374
374
375
</details>
375
376
377
## 查询用户关注明细2
378
379
<img src="/imgs/relation.svg" width="100" height="100" />
380
381
> https://app.biliapi.net/x/v2/relation/followings
382
383
*请求方式：GET*
384
385
认证方式：Cookie(SESSDATA)或APP
386
387
登录可看自己全部，其他用户仅可查看前5页，可以获取已设置可见性隐私的关注列表
388
389
**url参数：**
390
391
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
392
| ---------- | ---- | ------------ | ----------- | ------------------------------------------------------- |
393
| access_key | str | APP登录Token | APP方式必要 | |
394
| vmid | num | 目标用户mid | 必要 | |
395
| order_type | str | 排序方式 | 非必要 | 按照关注顺序排列：留空<br />按照最常访问排列：attention |
396
| ps | num | 每页项数 | 非必要 | 默认为50 |
397
| pn | num | 页码 | 非必要 | 默认为1<br />其他用户仅可查看前5页 |
398
399
**json回复：**
400
401
根对象：
402
403
| 字段 | 类型 | 内容 | 备注 |
404
| ------- | ---- | -------- | ------------------------------------------------------------ |
405
| code | num | 返回值 | 0：成功<br />-400：请求错误<br />22007：访问超过5页 |
406
| message | str | 错误信息 | 默认为0 |
407
| ttl | num | 1 | |
408
| data | obj | 信息本体 | |
409
410
data 对象：
411
412
| 字段 | 类型 | 内容 | 备注 |
413
| ---------- | ----- | -------- | ------------ |
414
| list | array | 明细列表 | |
415
| re_version | num | ？？？ | 作用尚不明确 |
416
| total | num | 关注总数 | |
417
418
`data`中的`list`数组：
419
420
| 项 | 类型 | 内容 | 备注 |
421
| ---- | ---- | --------- | ---------------- |
422
| 0 | obj | 关注1 | |
423
| n | obj | 关注(n+1) | 按照关注顺序排列 |
424
| …… | obj | …… | …… |
425
426
数组`list`中的对象：
427
428
| 字段 | 类型 | 内容 | 备注 |
429
| --------------- | ---------------------------------------- | ------------ | --------------------------------------- |
430
| mid | num | 用户mid | |
431
| attribute | num | 关注属性 | 0：未关注<br />2：已关注<br />6：已互粉 |
432
| mtime | num | 关注对方时间 | 时间戳<br />互关后刷新 |
433
| tag | 默认分组：null<br />存在至少一个分组：array | 分组id | |
434
| special | num | 特别关注标志 | 0：否<br />1：是 |
435
| uname | str | 用户昵称 | |
436
| face | str | 用户头像url | |
437
| sign | str | 用户签名 | |
438
| official_verify | obj | 认证信息 | |
439
| vip | obj | 会员信息 | |
440
441
数组`list`中的对象中的`tag`数组：
442
443
| 项 | 类型 | 内容 | 备注 |
444
| ---- | ---- | --------------------- | ---- |
445
| 0 | num | 位于分组1的分组id | |
446
| n | num | 位于分组(n+1)的分组id | |
447
| …… | num | …… | …… |
448
449
`list`中的对象中的`official_verify`对象：
450
451
| 字段 | 类型 | 内容 | 备注 |
452
| ---- | ---- | ------------ | ------------------- |
453
| type | num | 用户认证类型 | -1：无<br />1：认证 |
454
| desc | str | 用户认证信息 | 无为空 |
455
456
`list`中的对象中的`vip`对象：
457
458
| 字段 | 类型 | 内容 | 备注 |
459
| ------------- | ---- | ------------ | ----------------------------------------------- |
460
| vipType | num | 会员类型 | 0：无<br />1：月度大会员<br />2：年度以上大会员 |
461
| vipDueDate | num | 会员到期时间 | 时间戳 毫秒 |
462
| dueRemark | str | 空 | 作用尚不明确 |
463
| accessStatus | num | 0 | 作用尚不明确 |
464
| vipStatus | num | 大会员状态 | 0：无<br />1：有 |
465
| vipStatusWarn | str | 空 | 作用尚不明确 |
466
| themeType | num | 0 | 作用尚不明确 |
467
| label | obj | ？？？ | 作用尚不明确 |
468
469
`vip`中的`label`对象：
470
471
| 字段 | 类型 | 内容 | 备注 |
472
| ---- | ---- | ---- | ------------ |
473
| path | str | 空 | 作用尚不明确 |
474
475
**示例：**
476
477
获取用户`mid=293793435`的关注明细，按照关注顺序
478
479
```shell
480
curl -G 'https://app.biliapi.net/x/v2/relation/followings' \
481
--data-urlencode 'vmid=293793435' \
482
--data-urlencode 'order_type=' \
483
--data-urlencode 'ps=2' \
484
--data-urlencode 'pn=1' \
485
-b 'SESSDATA=xxx'
486
```
487
488
<details>
489
<summary>查看响应示例：</summary>
490
491
```json
492
{
493
"code": 0,
494
"message": "0",
495
"ttl": 1,
496
"data": {
497
"list": [{
498
"mid": 14082,
499
"attribute": 2,
500
"mtime": 1584271945,
501
"tag": null,
502
"special": 0,
503
"uname": "山新",
504
"face": "https://i0.hdslb.com/bfs/face/74c82caee6d9eb623e56161ea8ed6d68afabfeae.jpg",
505
"sign": "都说了是天依爹地，不是妈咪。\r私信有点多回复不过来～商业合作啥的请移步Weibo私信@山新 哦哦哦～",
506
"official_verify": {
507
"type": 0,
508
"desc": "配音演员、声优。洛天依声源提供者。"
509
},
510
"vip": {
511
"vipType": 2,
512
"vipDueDate": 1601654400000,
513
"dueRemark": "",
514
"accessStatus": 0,
515
"vipStatus": 1,
516
"vipStatusWarn": "",
517
"themeType": 0,
518
"label": {
519
"path": ""
520
}
521
}
522
}, {
523
"mid": 420831218,
524
"attribute": 2,
525
"mtime": 1584208169,
526
"tag": [207542],
527
"special": 0,
528
"uname": "支付宝Alipay",
529
"face": "https://i2.hdslb.com/bfs/face/aaf18aeb2d9822e28a590bd8d878572ca8c59e04.jpg",
530
"sign": "阿支来了，关注点赞转发投币四连走起！",
531
"official_verify": {
532
"type": 1,
533
"desc": "支付宝官方账号"
534
},
535
"vip": {
536
"vipType": 1,
537
"vipDueDate": 1585065600000,
538
"dueRemark": "",
539
"accessStatus": 0,
540
"vipStatus": 1,
541
"vipStatusWarn": "",
542
"themeType": 0,
543
"label": {
544
"path": ""
545
}
546
}
547
}],
548
"re_version": 3228575555,
549
"total": 699
550
}
551
}
552
```
553
554
</details>
555
376
556
## 搜索关注明细
377
557
378
558
<img src="/imgs/relation.svg" width="100" height="100" />