From 69afaf047d317824f00b99aa770e49daada79851 Mon Sep 17 00:00:00 2001
From: SessionHu <102411014+SessionHu@users.noreply.github.com>
Date: Sun, 20 Jul 2025 15:48:31 +0800
Subject: [PATCH] feat: add username to mid
close #1300
---
README.md | 1 +
docs/user/batch.md | 85 ++++++++++++++++++++++++++++++++++++++++++++++
2 files changed, 86 insertions(+)
create mode 100644 docs/user/batch.md
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
+}
+```
+
+
+