基本说明：
| 接口地址：https://apis.juhe.cn/fapigw/naming/query |
|---|
| 返回格式：json |
| 请求方式：get/post |
| 请求示例：https://apis.juhe.cn/fapigw/naming/query?key=key&surname=name |
请求参数说明：
| 名称 | 类型 | 必填 | 说明 |
|---|---|---|---|
| key | string | 必填 | 聚合密钥 扫码关注公众号 |
| surname | string | 必填 | 姓氏，长度支持1-4位 |
| sex | string | 选填 | 性别，boy或girl。默认：boy |
| limit | int | 选填 | 返回姓名数量，最大5；默认：5 |
返回参数说明：
| 名称 | 类型 | 说明 |
|---|---|---|
| data | array | 姓名结果列表 |
| name | string | 名字 |
| score | string | 名字评分 |
| tag | string | 名字标签 |
| description | string | 补充描述 |
JSON返回示例：
{
"reason": "success",
"result": {
"surname": "董",
"sex": "girl",
"limit": "2",
"data": [{
"name": "千芸",
"score": "94",
"tag": "五行属木,女孩名,推荐,90后",
"description": null
},
{
"name": "栗锦",
"score": "78",
"tag": "五行属金,五行属木,80后",
"description": null
}
]
},
"error_code": 0
}
服务级错误码参照
| 错误码 | 说明 |
|---|---|
| 10001 | 错误的请求KEY |
| 10002 | 该KEY无请求权限 |
| 10003 | KEY过期 |
| 10004 | 错误的OPENID |
| 10005 | 应用未审核超时，请提交认证 |
| 10007 | 未知的请求源 |
| 10008 | 被禁止的IP |
| 10009 | 被禁止的KEY |
| 10011 | 当前IP请求超过限制 |
| 10012 | 请求超过次数限制 |
| 10013 | 测试KEY超过请求限制 |
| 10014 | 系统内部异常 |
| 10020 | 接口维护 |
| 10021 | 接口停用 |
完整教学代码示例
<?php
/**
* Created by PhpStorm.
* User: FZS
* Time: 2023/10/03 14:26
*/
class freeApi
{
private $apiUrl;
public function __construct()
{
$this->apiUrl = 'https://apis.juhe.cn/fapigw/naming/query?key=key&surname=name';
}
/**
* 获取结果
* @return array
*/
public function getResult()
{
return file_get_contents($this->apiUrl);
}
}package main
import (
"fmt"
"io/ioutil"
"log"
"net/http"
)
const (
APIURL = "https://apis.juhe.cn/fapigw/naming/query?key=key&surname=name"
)
func main() {
queryUrl := fmt.Sprintf("%s",APIURL)
resp, err := http.Get(queryUrl)
if err != nil {
log.Println(err)
return
}
defer resp.Body.Close()
body, err := ioutil.ReadAll(resp.Body)
if err != nil {
fmt.Println(err)
return
}
fmt.Println(string(body))
}