diff --git a/README.md b/README.md index b4b57dd..a9ef41f 100644 --- a/README.md +++ b/README.md @@ -105,6 +105,7 @@ B站 API 采用 C/S 结构,大多数接口为 REST API 和 gRPC,少部分接 - [x] [用户认证类型一览](docs/user/official_role.md) - [ ] [加入老粉计划](docs/user/contract.md) - [x] [所有粉丝勋章](docs/user/medals.md) + - [ ] [批量查询](docs/user/batch.md) - [ ] [大会员](docs/vip) - [ ] [大会员基本信息](docs/vip/info.md) - [ ] [大会员中心](docs/vip/center.md) diff --git a/docs/user/batch.md b/docs/user/batch.md new file mode 100644 index 0000000..98953e9 --- /dev/null +++ b/docs/user/batch.md @@ -0,0 +1,85 @@ +# 批量查询 + +## 用户名查 mid + +### 动态 + +> https://api.bilibili.com/x/polymer/web-dynamic/v1/name-to-uid + +*请求方法: GET* + +认证方式: Cookie (SESSDATA) + + + +**URL 参数:** + +| 参数名 | 类型 | 内容 | 必要性 | 备注 | +| ------ | ------ | ------ | ------ | ---- | +| names | string | 用户名 | 必要 | 多个用户名以 `,` 分隔 | + +**JSON 回复:** + +根对象: + +| 字段 | 类型 | 内容 | 备注 | +| ---- | ---- | ---- | ---- | +| code | number | 返回值 | 0: 成功
-101: 账号未登录
-400: 请求错误 | +| data | object | 数据本体 | | +| message | string | 错误信息 | 成功时为 `0` | +| ttl | number | `1` | | + +`data` 对象: + +| 字段 | 类型 | 内容 | 备注 | +| ---- | ---- | ---- | ---- | +| uid_list | object[] | UID 列表 | 套了个娃 | + +`data.uid_list[]` 对象: + +| 字段 | 类型 | 内容 | 备注 | +| ---- | ---- | ---- | ---- | +| name | string | 用户名 | | +| uid | string | mid (UID) | | + +**示例:** + +```shell +curl -G 'https://api.bilibili.com/x/polymer/web-dynamic/v1/name-to-uid' \ +--url-query 'names=社会易姐qwq,session小胡,陈睿,洛天依' \ +-b 'SESSDATA=xxx' +``` + +
+查看响应示例: + +```json +{ + "code": 0, + "data": { + "uid_list": [ + { + "name": "社会易姐QwQ", + "uid": "293793435" + }, + { + "name": "陈睿", + "uid": "208259" + }, + { + "name": "Session小胡", + "uid": "645769214" + }, + { + "name": "洛天依", + "uid": "36081646" + } + ] + }, + "message": "0", + "ttl": 1 +} +``` +
+ +