随机昵称
随机生成可爱中文昵称,固定为前三个字+的+后两个字,如爱吃鱼的小猫
调用地址:https://api.ynlskj.com.cn/gateway/nickname
请求方法:GET
在其他地方怎么调用
- 请求地址用上面的调用地址,参数拼在网址后面,例如
?count=1 - 方法用
GET - API Key 只能放在请求头
X-API-Key,不要写进网址,也不要写进 Query 框 - Key 在「个人中心 → API Key」里复制,登录后会自动填入你自己的 Key
参数说明
| 参数 | 位置 | 必填 | 说明 |
|---|---|---|---|
count |
Query | 否 | 一次生成条数,1–20,默认 1。不传参数也可直接调用 |
X-API-Key |
Header | 是 | 你的 API Key(请求头,不要放进网址或 Query) |
请求示例
| 场景 | Query 示例 |
|---|---|
| 生成一个 | {} 或不传参数 |
| 一次生成 5 个 | {"count":5} |
返回说明
| 字段 | 说明 |
|---|---|
ret | ok 成功,err 失败 |
data.nickname | 本次生成的昵称,固定为「三字+的+二字」,如爱吃鱼的小猫 |
data.prefix / data.suffix | 前三个字、后两个字 |
data.nicknames | 全部结果数组。count=1 时也是长度为 1 的数组 |
msg | 本站提示,如「次数充足,剩余 99 次」或「次数不足,剩余 0 次」 |
remain_quota | 本次调用后的剩余次数 |
可直接复制的代码
未登录时示例只显示「你的密钥」。登录后会自动填入你自己的 Key,不会展示别人的。
<?php
$ch = curl_init('https://api.ynlskj.com.cn/gateway/nickname?count=1');
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => ['X-API-Key: 你的密钥'],
]);
echo curl_exec($ch);
请求参数演示
{
"count": 1
}
响应演示
{
"ret": "ok",
"data": {
"nickname": "爱吃鱼的小猫",
"prefix": "爱吃鱼",
"suffix": "小猫",
"count": 1,
"nicknames": [
{
"nickname": "爱吃鱼的小猫",
"prefix": "爱吃鱼",
"suffix": "小猫"
}
]
},
"msg": "次数充足,剩余 99 次",
"remain_quota": 99
}