

| Header名称 | 默认值 | 必填 | 说明 |
|---|---|---|---|
X-API-Key | 你的API密钥 | 是 | 逗号APIKEY,用户后台首页获取 |
Content-Type | application/json | 是 | 请求内容类型 |
| 参数名 | 默认值 | 必填 | 说明 |
|---|---|---|---|
api_id | 55 | 是 | API接口ID,系统默认 |
endpoint_id | ep_e5defc6555c13b32e3ae5c277eb1519c | 是 | 端点ID,系统默认 |
method | POST | 是 | 请求方式,可选值:GET,POST |
| 参数名 | 类型 | 必填 | 说明 | 示例 |
|---|---|---|---|---|
surname | string | 是 | 姓氏 | |
birthday | string | 是 | 出生日期 YYYY-MM-DD | |
birthTime | string | 是 | 出生时辰:子时~亥时(见接口详情) | |
gender | integer | 否 | 性别:0不限、1男、2女 | |
limit | integer | 否 | 返回数量 1-500 | |
| 参数名 | 类型 | 说明 | 示例 |
|---|---|---|---|
code | integer | 状态码,200表示成功 | |
message | string | 状态描述,如"起名成功" | |
data | object | 起名结果数据 | |
timestamp | integer | 服务器时间戳 | |
其他参数见接口详情 | string | |
{"code":200,"message":"起名成功","data":{"surname":"李","gender":"男","birthday":"2024-05-20","birth_time":"辰时","bazi":"甲辰 己巳 甲申 戊辰","xiyongshen":["火","土"],"jiyongshen":["金","水"],"qiming_advice":"八字喜用神:火、土;忌用神:金、水。命局金、水气场清冷肃敛偏亢,压制克制本命。取名宜用火土相生组合,生化流通、气机周流,以化解克制、扶助喜神。须避开金、水属性过强之字,兼顾音律、字形与内涵,饱含家人对孩子行稳致远、进而有为的殷切期许。","total_names":2,"names":[{"full_name":"李煜城","name":"煜城","score":98,"match_priority":3,"match_level":"最佳匹配","characters":{"surname":{"char":"李","strokes":7,"wuxing":"火","pinyin":"lǐ"},"char1":{"char":"煜","strokes":13,"wuxing":"火","pinyin":"yù","analysis":"煜字的五行为火,光明磊落,一生前程似锦。","meaning":"煜字用着取名寓指光明、照耀、辉煌之义。"},"char2":{"char":"城","strokes":10,"wuxing":"土","pinyin":"chéng","analysis":"城字的五行为土,稳重可靠,有领导才能。","meaning":"城字用着取名寓指坚固、稳重、大气之义。"}},"poetry":"取自唐代:王之涣《登鹳雀楼》欲穷千里目,更上一层楼。","gender":"男"},{"full_name":"李炎彬","name":"炎彬","score":95,"match_priority":2,"match_level":"良好匹配","characters":{"surname":{"char":"李","strokes":7,"wuxing":"火","pinyin":"lǐ"},"char1":{"char":"炎","strokes":8,"wuxing":"火","pinyin":"yán","analysis":"炎字的五行为火,热情开朗,充满活力。","meaning":"炎字用着取名寓指热情、光明、向上之义。"},"char2":{"char":"彬","strokes":11,"wuxing":"木","pinyin":"bīn","analysis":"彬字的五行为木,文雅有礼,品德高尚。","meaning":"彬字用着取名寓指文质彬彬、品德高尚之义。"}},"poetry":"取自《论语》文质彬彬,然后君子。","gender":"男"}]},"timestamp":1725000000}{"code":500,"message":"八字计算失败,请检查日期格式","data":null,"timestamp":1725000000}| 错误代码 | HTTP状态 | 错误信息 | 详细说明 |
|---|---|---|---|
| 暂无业务错误码 | |||
| 错误代码 | HTTP状态 | 错误信息 | 详细说明 |
|---|---|---|---|
401 | HTTP 401 | 认证失败 | 请求头中缺少 X-API-Key 或 API Key 无效 |
400 | HTTP 400 | 参数错误 | 缺少必要参数(api_id、endpoint_id、method)或必填业务参数缺失 |
404 | HTTP 404 | 资源不存在 | API不存在、已下架或端点不存在 |
403 | HTTP 403 | 未开通 | 您尚未开通此API,请先开通 |
405 | HTTP 405 | 方法不允许 | 请求方法不在端点允许列表中 |
402 | HTTP 402 | 积分不足 | 账户积分不足以调用该API |
500 | HTTP 500 | 服务器内部错误 | 系统异常 |
| 值 | 时间范围 | 值 | 时间范围 |
|---|---|---|---|
| 子时 | 23:00-01:00 | 午时 | 11:00-13:00 |
| 丑时 | 01:00-03:00 | 未时 | 13:00-15:00 |
| 寅时 | 03:00-05:00 | 申时 | 15:00-17:00 |
| 卯时 | 05:00-07:00 | 酉时 | 17:00-19:00 |
| 辰时 | 07:00-09:00 | 戌时 | 19:00-21:00 |
| 巳时 | 09:00-11:00 | 亥时 | 21:00-23:00 |
| 参数名 | 类型 | 说明 |
|---|---|---|
| code | int | 状态码,200表示成功 |
| message | string | 状态描述,如"起名成功" |
| data | object | 起名结果数据 |
| timestamp | int | 服务器时间戳 |
| 参数名 | 类型 | 说明 |
|---|---|---|
| surname | string | 用户输入的姓氏 |
| gender | string | 性别:男/女/不限 |
| birthday | string | 出生日期,格式:YYYY-MM-DD |
| birth_time | string | 出生时辰,如:辰时 |
| bazi | string | 八字(四柱),如:甲辰 己巳 甲申 戊辰 |
| xiyongshen | array | 喜用神五行数组,如:["火", "土"] |
| jiyongshen | array | 忌用神五行数组,如:["金", "水"] |
| qiming_advice | string | 起名建议文案 |
| total_names | int | 返回的名字数量 |
| names | array | 名字列表 |
| 参数名 | 类型 | 说明 |
|---|---|---|
| full_name | string | 完整姓名(姓氏+名字),如:"李煜城" |
| name | string | 名字(不含姓氏),如:"煜城" |
| score | int | 综合评分(1-100分) |
| match_priority | int | 匹配优先级:3=最佳、2=良好、1=一般 |
| match_level | string | 匹配等级描述:最佳匹配/良好匹配/一般匹配 |
| characters | object | 字符详细信息 |
| poetry | string | 选自诗词 |
| gender | string | 适用性别:男/女 |
| 参数名 | 类型 | 说明 |
|---|---|---|
| surname | object | 姓氏字符信息 |
| char1 | object | 名字第一个字信息 |
| char2 | object | 名字第二个字信息 |
| 参数名 | 类型 | 说明 |
|---|---|---|
| char | string | 字符,如:"李" |
| strokes | int | 康熙笔画数,如:7 |
| wuxing | string | 五行属性,如:"火" |
| pinyin | string | 拼音,如:"lǐ" |
| 参数名 | 类型 | 说明 |
|---|---|---|
| char | string | 字符,如:"煜" |
| strokes | int | 康熙笔画数,如:13 |
| wuxing | string | 五行属性,如:"火" |
| pinyin | string | 拼音,如:"yù" |
| analysis | string | 用字分析说明 |
| meaning | string | 用字寓意说明 |
<?php
// 以 宝宝起名(ID:55) 为例,以下为PHP请求示例:
$gateway_url = "https://api.douhao.com/gateway";
// 系统参数
$gatewayData = array(
'api_id' => 55,
'endpoint_id' => 'ep_e5defc6555c13b32e3ae5c277eb1519c',
'method' => 'GET,POST'
);
// 业务参数(请填写实际值)
$bizParams = array(
'surname' => '', // 请填写实际值,
'birthday' => '', // 请填写实际值,
'birthTime' => '', // 请填写实际值,
'gender' => '', // 请填写实际值,
'limit' => '', // 请填写实际值
);
// 合并请求数据
$requestData = array_merge($gatewayData, $bizParams);
// 请求头(请替换为您的API密钥)
$headers = array(
'Content-Type: application/json',
'X-API-Key: 您的API密钥'
);
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $gateway_url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_TIMEOUT, 180);
curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, false);
curl_setopt($ch, CURLOPT_SSL_VERIFYHOST, false);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($requestData, JSON_UNESCAPED_UNICODE));
curl_setopt($ch, CURLOPT_HTTPHEADER, $headers);
$response = curl_exec($ch);
$error = curl_error($ch);
$httpCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);
if ($error) {
echo "请求错误: " . $error;
} else {
echo "HTTP状态码: " . $httpCode . "\n";
echo "响应数据: " . $response;
}
?>#!/usr/bin/env python3
# -*- coding: utf-8 -*-
import requests
import json
# API网关地址
gateway_url = "https://api.douhao.com/gateway"
# 系统参数
gateway_data = {
'api_id': 55,
'endpoint_id': 'ep_e5defc6555c13b32e3ae5c277eb1519c',
'method': 'GET,POST'
}
# 业务参数(请填写实际值)
biz_params = {
'surname': '', # 请填写实际值,
'birthday': '', # 请填写实际值,
'birthTime': '', # 请填写实际值,
'gender': '', # 请填写实际值,
'limit': '', # 请填写实际值
}
# 合并请求参数
request_data = {**gateway_data, **biz_params}
# 请求头(请替换为您的API密钥)
headers = {
'Content-Type': 'application/json',
'X-API-Key': '您的API密钥'
}
try:
response = requests.post(
gateway_url,
json=request_data,
headers=headers,
timeout=180,
verify=False # 生产环境建议设为True
)
print(f"HTTP状态码: {response.status_code}")
print("响应数据:")
print(json.dumps(response.json(), indent=2, ensure_ascii=False))
except requests.exceptions.RequestException as e:
print(f"请求错误: {e}")// 以 宝宝起名(ID:55) 为例,以下为Node.js请求示例
// 需要先安装 axios: npm install axios
const axios = require('axios');
// API网关地址
const gatewayUrl = 'https://api.douhao.com/gateway';
// 系统参数
const gatewayData = {
api_id: 55,
endpoint_id: 'ep_e5defc6555c13b32e3ae5c277eb1519c',
method: 'GET,POST'
};
// 业务参数(请填写实际值)
const bizParams = {
"surname": "", // 请填写实际值,
"birthday": "", // 请填写实际值,
"birthTime": "", // 请填写实际值,
"gender": "", // 请填写实际值,
"limit": "", // 请填写实际值
};
// 合并请求参数
const requestData = { ...gatewayData, ...bizParams };
// 请求头(请替换为您的API密钥)
const headers = {
'Content-Type': 'application/json',
'X-API-Key': '您的API密钥'
};
async function callApi() {
try {
const response = await axios.post(gatewayUrl, requestData, {
headers: headers,
timeout: 180000
});
console.log('HTTP状态码:', response.status);
console.log('响应数据:');
console.log(JSON.stringify(response.data, null, 2));
} catch (error) {
if (error.response) {
console.log('HTTP状态码:', error.response.status);
console.log('错误响应:', error.response.data);
} else {
console.log('请求错误:', error.message);
}
}
}
callApi();// 以 宝宝起名(ID:55) 为例,以下为Java请求示例
// 需要依赖:okhttp 和 gson
import okhttp3.*;
import com.google.gson.Gson;
import com.google.gson.GsonBuilder;
import java.util.HashMap;
import java.util.Map;
import java.util.concurrent.TimeUnit;
public class ApiDemo {
private static final String GATEWAY_URL = "https://api.douhao.com/gateway";
private static final Gson gson = new GsonBuilder().setPrettyPrinting().create();
public static void main(String[] args) throws Exception {
// 系统参数
Map<String, Object> gatewayData = new HashMap<>();
gatewayData.put("api_id", 55);
gatewayData.put("endpoint_id", "ep_e5defc6555c13b32e3ae5c277eb1519c");
gatewayData.put("method", "GET,POST");
// 业务参数(请填写实际值)
Map<String, Object> bizParams = new HashMap<>();
map.put("surname", ""); // 请填写实际值
map.put("birthday", ""); // 请填写实际值
map.put("birthTime", ""); // 请填写实际值
map.put("gender", ""); // 请填写实际值
map.put("limit", ""); // 请填写实际值
// 合并请求数据
Map<String, Object> requestData = new HashMap<>(gatewayData);
requestData.putAll(bizParams);
// 请求体JSON
String jsonBody = gson.toJson(requestData);
// 创建请求
OkHttpClient client = new OkHttpClient.Builder()
.connectTimeout(180, TimeUnit.SECONDS)
.readTimeout(180, TimeUnit.SECONDS)
.build();
RequestBody body = RequestBody.create(
jsonBody,
MediaType.parse("application/json; charset=utf-8")
);
Request request = new Request.Builder()
.url(GATEWAY_URL)
.post(body)
.addHeader("Content-Type", "application/json")
.addHeader("X-API-Key", "您的API密钥") // 请替换为您的API密钥
.build();
try (Response response = client.newCall(request).execute()) {
System.out.println("HTTP状态码: " + response.code());
String responseBody = response.body().string();
System.out.println("响应数据:");
System.out.println(gson.toJson(gson.fromJson(responseBody, Object.class)));
}
}
}# 以 宝宝起名(ID:55) 为例,以下为cURL请求示例
curl -X POST "https://api.douhao.com/gateway" \
-H "Content-Type: application/json" \
-H "X-API-Key: 您的API密钥" \
-d '{
"api_id": 55,
"endpoint_id": "ep_e5defc6555c13b32e3ae5c277eb1519c",
"method": "GET,POST",
"surname": "" // 请填写实际值,
"birthday": "" // 请填写实际值,
"birthTime": "" // 请填写实际值,
"gender": "" // 请填写实际值,
"limit": "" // 请填写实际值
}'
浙公网安备 33059102000262号