# 八字喜用神起名大师 Api 接口

AI/模型 基于八字命理和五行相生相克理论 十年模型积累 / 三才五格数理 姓名 / 八字命理

![gugudata api](https://static.gugudata.com/api_cover_name_generator.png align="left")

## **1\. 产品功能**

* 基于传统八字命理学理论；
    
* 结合三才五格数理分析；
    
* 考虑五行相生相克关系；
    
* 提供多个候选姓名供选择；
    
* 包含详细的命理分析报告；
    
* 支持方言谐音检测；
    
* 全接口支持 HTTPS（TLS v1.0 / v1.1 / v1.2 / v1.3）；
    
* 全面兼容 Apple ATS；
    
* 全国多节点 CDN 部署；
    
* 接口极速响应，多台服务器构建 API 接口负载均衡；
    
* [接口调用状态与状态监控](https://www.gugudata.com/status)
    

# **2\. API 文档**

**接口详情:** [https://www.gugudata.com/api/details/name-generator](https://www.gugudata.com/api/details/name-generator)

**接口地址:** [https://api.gugudata.com/ai/name-generator?appkey=](https://api.gugudata.com/ai/name-generator?appkey=){{appkey}}

**返回格式:** application/json; charset=utf-8

**请求方式:** POST

**请求协议:** HTTPS

**请求示例:** [https://api.gugudata.com/ai/name-generator?appkey=](https://api.gugudata.com/ai/name-generator?appkey=){{appkey}}

**数据预览:** [https://www.gugudata.com/preview/name-generator](https://www.gugudata.com/preview/name-generator)

**接口测试:** [https://api.gugudata.com/ai/name-generator/demo](https://api.gugudata.com/ai/name-generator/demo)

# **3\. 请求参数**

| **参数名** | **参数类型** | **是否必须** | **默认值** | **备注** |
| --- | --- | --- | --- | --- |
| lastname | string | 是 |  | 姓氏 |
| gender | string | 是 |  | 性别（男/女） |
| birthdatetime | string | 是 | N/A | 公历出生年月日时，格式：YYYY年MM月DD日 HH:MM |
| birthplace | string | 是 | N/A | 出生地点（省市），用于规避可能的谐音 |
| parentnames | string | 否 |  | 父母姓名（可选，用于亲子音韵搭配） |
| avoidwords | string | 否 |  | 可选避用字（可选，多个字用逗号分隔） |

# **4\. 返回参数**

| **参数名** | **参数类型** | **备注** |
| --- | --- | --- |
| DataStatus.StatusCode | int | 接口返回状态码 |
| DataStatus.StatusDescription | string | 接口返回状态说明 |
| DataStatus.ResponseDateTime | string | 接口数据返回时间 |
| DataStatus.DataTotalCount | int | 此条件下的总数据量，一般用于分页计算 |
| Data | object | 接口返回的完整 JSON 数据，包含命盘分析、候选名字清单、最佳推荐、注意事项等所有字段，具体可查看 [DEMO 接口](https://www.gugudata.com/preview/name-generator) 返回数据 |