feat: add username to mid

close #1300
This commit is contained in:
SessionHu 2025-07-20 15:48:31 +08:00
parent 9b7f98d06f
commit 69afaf047d
No known key found for this signature in database
GPG Key ID: 9E7E64C25FE3301A
2 changed files with 86 additions and 0 deletions

View File

@ -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)

85
docs/user/batch.md Normal file
View File

@ -0,0 +1,85 @@
# 批量查询
## 用户名查 mid
### 动态
> https://api.bilibili.com/x/polymer/web-dynamic/v1/name-to-uid
*请求方法: GET*
认证方式: Cookie (SESSDATA)
<!-- from #1300 -->
**URL 参数:**
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------ | ------ | ------ | ------ | ---- |
| names | string | 用户名 | 必要 | 多个用户名以 `,` 分隔 |
**JSON 回复:**
根对象:
| 字段 | 类型 | 内容 | 备注 |
| ---- | ---- | ---- | ---- |
| code | number | 返回值 | 0: 成功<br />-101: 账号未登录<br />-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'
```
<details>
<summary>查看响应示例:</summary>
```json
{
"code": 0,
"data": {
"uid_list": [
{
"name": "社会易姐QwQ",
"uid": "293793435"
},
{
"name": "陈睿",
"uid": "208259"
},
{
"name": "Session小胡",
"uid": "645769214"
},
{
"name": "洛天依",
"uid": "36081646"
}
]
},
"message": "0",
"ttl": 1
}
```
</details>
<!-- Generated by json-apidoc-gen @ 2025-07-20T07:26:44.13468349Z -->