bilibili-API-collect/user/check_nickname.md

# 检查昵称是否可注册

- [检查昵称](#检查昵称)

---

## 检查昵称

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