在开发聊天机器人、虚拟用户系统或游戏角色时,为每个账户生成独特的昵称是关键需求。接口盒子(apihz.cn)提供的随机昵称网名API,拥有百万级昵称库,可免费生成自然流畅的中文网名。以下是详细使用指南:
一、接口基础信息
-
功能:随机返回一个中文昵称(如"豌豆公主""星空旅人")
-
请求地址 :
https://cn.apihz.cn/api/zici/sjwm.php
-
请求方式 :
GET
或POST
-
必填参数:
参数名 说明 示例值 id
用户中心的数字ID id=10000000
key
用户中心通讯秘钥 key=15he5hxx...
-
返回参数:
code
:状态码(200
=成功,400
=错误)msg
:成功返回昵称,失败返回错误信息
二、调用示例代码
1. PHP 示例(GET请求)
php
php
复制
<?php
$api_url = "https://cn.apihz.cn/api/zici/sjwm.php";
$user_id = "10000000"; // 替换为你的ID
$user_key = "your_secret_key"; // 替换为你的KEY
// 发起GET请求
$url = $api_url . "?id=" . urlencode($user_id) . "&key=" . urlencode($user_key);
$response = file_get_contents($url);
$data = json_decode($response, true);
// 处理结果
if ($data['code'] == 200) {
echo "随机昵称:" . $data['msg'];
} else {
echo "错误:" . $data['msg'];
}
?>
2. Python 示例(POST请求)
ini
python
运行
复制
import requests
api_url = "https://cn.apihz.cn/api/zici/sjwm.php"
user_id = "10000000" # 替换为你的ID
user_key = "your_secret_key" # 替换为你的KEY
# 发起POST请求
params = {"id": user_id, "key": user_key}
response = requests.post(api_url, data=params)
data = response.json()
# 处理结果
if data['code'] == 200:
print("随机昵称:", data['msg'])
else:
print("错误:", data['msg'])
三、返回数据示例
✅ 成功响应:
css
json
复制
{"code": 200, "msg": "星河漫游者"}
❌ 错误响应:
css
json
复制
{"code": 400, "msg": "通讯秘钥错误"}
四、重要注意事项
-
必用个人ID/KEY :
文档示例中的公共ID(
88888888
)和KEY(88888888
)共享频次限制,需注册接口盒子账号获取独享密钥。 -
频率限制:
- 公共密钥:每分钟限次(易被他人占用)
- 个人密钥:独享每分钟调用频次,每日无总量上限
-
版权声明 :
数据来源参考官方文档,禁止商用侵权。
五、适用场景
- 🤖 聊天机器人昵称生成
- 🎮 游戏NPC随机名称
- 📱 虚拟用户注册填充
- 💡 创意文案灵感来源
提示 :首次使用前,请前往接口盒子官网注册账号,在用户中心获取专属
id
和key
替换示例代码!
通过此API,开发者无需维护昵称库,即可快速获取自然流畅的中文网名,大幅提升开发效率!