bilibili-API-collect/docs/user/check_nickname.md
2023-02-23 11:48:58 +08:00

134 lines
2.7 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# 检查昵称是否可注册
## 检查昵称
> https://passport.bilibili.com/web/generic/check/nickname
*请求方式:GET*
也可用于判断指定昵称的用户是否存在
**url参数**
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| -------- | ---- | ----------- | ------ | ---- |
| nickName | str | 目标昵称 | 必要 | 最长为16字符 |
**json回复**
根对象:
| 字段 | 类型 | 内容 | 备注 |
| ------- | ---- | -------- | --------------------------- |
| code | num | 状态码 | -400请求错误<br />-500服务器端异常<br />**详细说明见下一表格** |
| message | str | 错误详情 | 若昵称可用则不返回message |
`code`状态码:
| 值 | 含义 |
| ----- | --------------------------------- |
| 0 | 昵称未被注册 |
| 2001 | 该昵称已被他人使用 |
| 40002 | 昵称包含敏感信息 |
| 40004 | 昵称不可包含除\-和_以外的特殊字符 |
| 40005 | 昵称过长超过16字符 |
| 40006 | 昵称过短少于2字符 |
| 40014 | 昵称已存在 |
**示例:**
查询昵称 `xijinping` 是否被使用:
```shell
curl -G 'https://passport.bilibili.com/web/generic/check/nickname' \
--data-urlencode 'nickName=xijinping'
```
<details>
<summary>查看响应示例:</summary>
```json
{
"code":40002,
"message":"昵称包含敏感信息"
}
```
</details>
查询昵称 `//` 是否被使用:
```shell
curl -G 'https://passport.bilibili.com/web/generic/check/nickname' \
--data-urlencode 'nickName=//'
```
<details>
<summary>查看响应示例:</summary>
```json
{
"code": 40004,
"message": "昵称不可包含除-和_以外的特殊字符"
}
```
</details>
查询昵称 `test0000000000000 ` 是否被使用:
```shell
curl -G 'https://passport.bilibili.com/web/generic/check/nickname' \
--data-urlencode 'nickName=test0000000000000 '
```
<details>
<summary>查看响应示例:</summary>
```json
{
"code": 40005,
"message": "昵称过长"
}
```
</details>
查询昵称 `0` 是否被使用:
```shell
curl -G 'https://passport.bilibili.com/web/generic/check/nickname' \
--data-urlencode 'nickName=0'
```
<details>
<summary>查看响应示例:</summary>
```json
{
"code": 40006,
"message": "昵称过短"
}
```
</details>
查询昵称 `test` 是否被使用:
```shell
curl -G 'https://passport.bilibili.com/web/generic/check/nickname' \
--data-urlencode 'nickName=test'
```
<details>
<summary>查看响应示例:</summary>
```json
{
"code":40014,
"message":"昵称已存在"
}
```
</details>