返回提交历史
Modified
docs/user/relation.md
+104
-19
XFEstudio/bilibili-API-collect
Update relation.md
2871403
代码差异
1 个文件
+104
-19
@@ -202,7 +202,7 @@ curl -G 'https://api.bilibili.com/x/relation/followers' \
202
202
| ttl | num | 1 | |
203
203
| data | obj | 信息本体 | |
204
204
205
data 对象：
205
`data`对象：
206
206
207
207
| 字段 | 类型 | 内容 | 备注 |
208
208
| ---------- | ----- | -------- | ------------ |
@@ -356,32 +356,28 @@ curl -G 'https://api.bilibili.com/x/relation/followings' \
356
356
357
357
*请求方式：GET*
358
358
359
认证方式：Cookie(SESSDATA)或APP
360
361
登录可看自己全部，其他用户仅可查看前5页，可以获取已设置可见性隐私的关注列表
359
仅可查看前5页，可以获取已设置可见性隐私的关注列表
362
360
363
361
**url参数：**
364
362
365
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
366
| ---------- | ---- | ------------ | ----------- | ------------------------------------------------------- |
367
| access_key | str | APP登录Token | APP方式必要 | |
368
| vmid | num | 目标用户mid | 必要 | |
369
| order_type | str | 排序方式 | 非必要 | 按照关注顺序排列：留空<br />按照最常访问排列：attention |
370
| ps | num | 每页项数 | 非必要 | 默认为50 |
371
| pn | num | 页码 | 非必要 | 默认为1<br />其他用户仅可查看前5页 |
363
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
364
| ---------- | ---- | ------------ | ------ | -------------------------- |
365
| vmid | num | 目标用户mid | 必要 | |
366
| ps | num | 每页项数 | 非必要 | 默认为50 |
367
| pn | num | 页码 | 非必要 | 默认为1<br />仅可查看前5页 |
372
368
373
369
**json回复：**
374
370
375
371
根对象：
376
372
377
| 字段 | 类型 | 内容 | 备注 |
378
| ------- | ---- | -------- | ------------------------------------------------------------ |
373
| 字段 | 类型 | 内容 | 备注 |
374
| ------- | ---- | -------- | --------------------------------------------------- |
379
375
| code | num | 返回值 | 0：成功<br />-400：请求错误<br />22007：访问超过5页 |
380
| message | str | 错误信息 | 默认为0 |
381
| ttl | num | 1 | |
382
| data | obj | 信息本体 | |
376
| message | str | 错误信息 | 默认为0 |
377
| ttl | num | 1 | |
378
| data | obj | 信息本体 | |
383
379
384
data 对象：
380
`data`对象：
385
381
386
382
| 字段 | 类型 | 内容 | 备注 |
387
383
| ---------- | ----- | -------- | ------------ |
@@ -453,10 +449,8 @@ data 对象：
453
449
```shell
454
450
curl -G 'https://app.biliapi.net/x/v2/relation/followings' \
455
451
--data-urlencode 'vmid=293793435' \
456
452
--data-urlencode 'ps=2' \
457
453
--data-urlencode 'pn=1' \
458
-b 'SESSDATA=xxx'
459
454
```
460
455
461
456
<details>
@@ -527,6 +521,97 @@ curl -G 'https://app.biliapi.net/x/v2/relation/followings' \
527
521
528
522
</details>
529
523
524
## 查询用户关注明细3
525
526
<img src="../../assets/img/relation.svg" width="100" height="100" />
527
528
> https://line3-h5-mobile-api.biligame.com/game/center/h5/user/relationship/following_list
529
530
*请求方式：GET*
531
532
可获取用户所有关注列表，对于设置了可见性隐私的用户会返回空列表
533
534
**url参数：**
535
536
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
537
| ------ | ---- | ------------ | ----------- | -------- |
538
| vmid | num | 目标用户mid | 必要 | |
539
| ps | num | 每页项数 | 非必要 | 默认为50 |
540
| pn | num | 页码 | 非必要 | 默认为1 |
541
542
**json回复：**
543
544
根对象：
545
546
| 字段 | 类型 | 内容 | 备注 |
547
| ---------- | ---- | ---------- | --------------------------- |
548
| code | num | 返回值 | 0：成功<br />-400：请求错误 |
549
| message | str | 错误信息 | 成功时无此项 |
550
| data | obj | 信息本体 | 失败时无此项 |
551
| ts | num | 当前时间戳 | 单位为毫秒 |
552
| request_id | str | 请求id | |
553
554
`data`对象：
555
556
| 字段 | 类型 | 内容 | 备注 |
557
| ---------- | ----- | -------- | ------------ |
558
| list | array | 明细列表 | |
559
560
`data`中的`list`数组：
561
562
| 项 | 类型 | 内容 | 备注 |
563
| ---- | ---- | --------- | ---------------- |
564
| 0 | obj | 关注1 | |
565
| n | obj | 关注(n+1) | 按照关注顺序排列 |
566
| …… | obj | …… | …… |
567
568
数组`list`中的对象：
569
570
| 字段 | 类型 | 内容 | 备注 |
571
| --------------- | ---- | ----------- | --------------------------------------- |
572
| mid | str | 用户mid | |
573
| attribute | num | 关注属性 | 0：未关注<br />2：已关注<br />6：已互粉 |
574
| uname | str | 用户昵称 | |
575
| face | str | 用户头像url | |
576
577
**示例：**
578
579
获取用户`mid=293793435`的关注明细
580
581
```shell
582
curl -G 'https://line3-h5-mobile-api.biligame.com/game/center/h5/user/relationship/following_list' \
583
--data-urlencode 'vmid=293793435' \
584
--data-urlencode 'ps=2' \
585
--data-urlencode 'pn=1' \
586
-b 'SESSDATA=xxx'
587
```
588
589
<details>
590
<summary>查看响应示例：</summary>
591
592
```json
593
{
594
"code": 0,
595
"data": {
596
"list": [{
597
"mid": "14082",
598
"attribute": 2,
599
"uname": "山新",
600
"face": "https://i0.hdslb.com/bfs/face/74c82caee6d9eb623e56161ea8ed6d68afabfeae.jpg"
601
}, {
602
"mid": "420831218",
603
"attribute": 2,
604
"uname": "支付宝Alipay",
605
"face": "https://i2.hdslb.com/bfs/face/aaf18aeb2d9822e28a590bd8d878572ca8c59e04.jpg"
606
}]
607
},
608
"ts": 1677410818395,
609
"request_id": "d9d541b9f2d24e21821e2d6d2d16c17d"
610
}
611
```
612
613
</details>
614
530
615
## 搜索关注明细
531
616
532
617
<img src="../../assets/img/relation.svg" width="100" height="100" />