在开发聊天机器人、虚拟用户系统或游戏角色时，为每个账户生成独特的昵称是关键需求。接口盒子提供的随机昵称网名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 $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": "通讯秘钥错误"}
四、重要注意事项
- 必用个人ID/KEY：
文档示例中的公共ID（88888888）和KEY（88888888）共享频次限制，需注册接口盒子账号获取独享密钥。 - 频率限制：
- 公共密钥：每分钟限次（易被他人占用）
- 个人密钥：独享每分钟调用频次，每日无总量上限
- 版权声明：
数据来源参考官方文档，禁止商用侵权。
五、适用场景
- 🤖 聊天机器人昵称生成
- 🎮 游戏NPC随机名称
- 📱 虚拟用户注册填充
- 💡 创意文案灵感来源
提示：首次使用前，请前往接口盒子官网注册账号，在用户中心获取专属
id和key替换示例代码！
通过此API，开发者无需维护昵称库，即可快速获取自然流畅的中文网名，大幅提升开发效率！
