随机昵称网名API接口教程：轻松获取百万创意昵称库

在开发聊天机器人、虚拟用户系统或游戏角色时，为每个账户生成独特的昵称是关键需求。接口盒子（apihz.cn）提供的随机昵称网名API，拥有百万级昵称库，可免费生成自然流畅的中文网名。以下是详细使用指南：

---

一、接口基础信息

1. ​功能​：随机返回一个中文昵称（如"豌豆公主""星空旅人"）

2. ​请求地址 ​：
   https://cn.apihz.cn/api/zici/sjwm.php

3. ​请求方式 ​：
   GET 或 POST

4. ​必填参数​：

   参数名	说明	示例值
   id	用户中心的数字ID	id=10000000
   key	用户中心通讯秘钥	key=15he5hxx...

5. ​返回参数​：

   • code：状态码（200=成功，400=错误）
   • msg：成功返回昵称，失败返回错误信息

---

二、调用示例代码

1. PHP 示例（GET请求）

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请求）

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'])

---

三、返回数据示例

✅ ​成功响应​：

json
复制
{"code": 200, "msg": "星河漫游者"}

❌ ​错误响应​：

json
复制
{"code": 400, "msg": "通讯秘钥错误"}

---

四、重要注意事项

1. ​必用个人ID/KEY ​：

   文档示例中的公共ID（88888888）和KEY（88888888）​共享频次限制，需注册接口盒子账号获取独享密钥。

2. ​频率限制​：

   • 公共密钥：每分钟限次（易被他人占用）
   • 个人密钥：独享每分钟调用频次，每日无总量上限

3. ​版权声明 ​：

   数据来源参考官方文档，禁止商用侵权。

---

五、适用场景

• 🤖 聊天机器人昵称生成
• 🎮 游戏NPC随机名称
• 📱 虚拟用户注册填充
• 💡 创意文案灵感来源

​提示 ​：首次使用前，请前往接口盒子官网注册账号，在用户中心获取专属id和key替换示例代码！

通过此API，开发者无需维护昵称库，即可快速获取自然流畅的中文网名，大幅提升开发效率！