• API 功能

    • 根据性别、历法、出生日期、时间和地点生成紫微主题文化解读,适合传统文化阅读产品;
    • 支持公历与农历资料,并提供农历闰月标记,便于表达不同历法下的出生信息;
    • 结果包含基本信息,便于读者先核对查询对象和出生资料,再阅读对应的文化内容;
    • 提供命盘摘要作为报告的阅读入口,便于展示主题提要并连接各项详细解读;
    • 包含十二宫位的文化解读,可在报告中按宫位分组展示并保留各自的解释内容;
    • 提供主星与辅星相关说明,适合将传统星曜术语与具体解读组合成阅读章节;
    • 提供四化分析内容,便于在紫微主题报告中单独呈现这一传统文化解释维度;
    • 包含大限与流年主题的文化内容,可按不同时间维度组织章节,方便读者对照阅读;
    • 提供综合建议与分项说明,便于在完整报告之外制作摘要页和章节导航;
    • 支持同步返回、异步任务及流式获取,可用于完整报告查询或逐步展示的文化阅读页面;
    • 默认最大 QPS:5,可在开发者中心自助升级,月付年付订单接口调用次数不限。
    • 接口调用状态与状态监控
  • API 文档

    接口地址: https://api.gugudata.com/ai/ziwei-fortune

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

    请求方式: POST

    请求协议: HTTPS

    请求示例: https://api.gugudata.com/ai/ziwei-fortune?appkey=YOUR_APPKEY

    数据预览: https://www.gugudata.com/preview/ziwei-fortune

    接口测试:  https://api.gugudata.com/ai/ziwei-fortune/demo

    OpenAPI: https://www.gugudata.com/openapi/gugudata.openapi.3.1.json

    请求参数(POST 请求参数以 application/json 格式传递;鉴权方式请参见下方示例代码)

    参数名 参数类型 是否必须 默认值 备注
    appkey string 是 无 付费后获取的 APPKEY
    gender string 是 无 性别,如:男、女。
    calendarType string 是 无 历法类型,如:公历、农历。
    birthDate string 是 无 出生日期,格式:YYYY-MM-DD。
    birthTime string 是 无 出生时间,格式:HH:MM。
    birthPlace string 是 无 非空白出生地点,作为传统文化解读的补充资料。
    isLeapMonth boolean 否 false 农历出生时是否为闰月,公历场景可保持 false。
    streaming boolean 否 false 默认 false;true 使用 SSE:type=content/text 片段、type=done/full_text 完整 JSON 文本、event=end/data=[DONE]。错误或不完整流不发送成功终态。task 模式必须为 false。
    responseMode string 否 sync 默认 sync;task 返回受理结果,通过 pollingUrl 查询。调用包在受理时预留,成功确认扣次,失败或未完成过期时退回;轮询不扣次。

    返回参数

    参数名 参数类型 备注
    DataStatus.RequestParameter string 本次完整真实业务输入,以可读 JSON 展示,不包含鉴权凭据。
    DataStatus.StatusCode integer 接口返回状态码
    DataStatus.StatusDescription string 接口返回状态说明
    DataStatus.ResponseDateTime string 接口数据返回时间
    DataStatus.DataTotalCount integer 此条件下的总数据量,一般用于分页计算
    Data.基本信息 object 命盘推演所使用的基础出生信息
    Data.命盘摘要 string 对整体命格与人生节奏的综合概述
    Data.十二宫位 object 命宫、财帛宫、事业宫等十二宫位的解读
    Data.主星与辅星 object 主星格局与辅星亮点分析
    Data.四化分析 object 化禄、化权、化科、化忌的推演结果
    Data.大限 array 分阶段的大限主题与趋势解读
    Data.流年趋势 object 近一年、近三年的趋势变化与提醒
    Data.综合建议 object 事业、财运、感情、健康等方向的综合建议
    Data.operationId string 仅 responseMode=task 时返回,任务唯一标识。
    Data.status string 仅 responseMode=task 或轮询接口返回,状态枚举:PENDING、RUNNING、SUCCEEDED、FAILED、EXPIRED。
    Data.pollingUrl string 仅 responseMode=task 或轮询接口返回,任务状态查询地址。
    Data.expiresAt string 仅 responseMode=task 或轮询接口返回,任务结果过期时间。
    Data.result object 仅任务状态为 SUCCEEDED 时返回,业务结果结构与同步模式一致。
    Data.error object 仅任务状态为 FAILED 时返回,失败原因信息。
    Data.免责声明 string 传统文化解读的适用范围与使用说明。

    响应示例(真实数据节选)

    接口数据预览

    仅展示部分示例数据,数组最多展示 3 项,长内容已省略;完整数据请调用接口获取。

    {
      "DataStatus": {
        "RequestParameter": "{\"gender\":\"女\",\"calendarType\":\"公历\",\"birthDate\":\"1990-12-01\",\"birthTime\":\"07:00\",\"birthPlace\":\"江苏苏州\",\"isLeapMonth\":false,\"streaming\":false,\"responseMode\":\"sync\"}",
        "StatusCode": 100,
        "StatusDescription": "固定示例,仅用于展示响应格式。",
        "ResponseDateTime": "2026-10-06 13:50:40.968",
        "DataTotalCount": 1
      },
      "Data": {
        "基本信息": {
          "性别": "女",
          "历法": "公历",
          "出生日期": "1990-12-01",
          "出生时间": "07:00",
          "出生地点": "江苏苏州",
          "是否闰月": false
        },
        "命盘摘要": "根据您提供的出生信息,以下内容基于紫微斗数传统文化意象进行介绍。紫微斗数是一种历史悠久的民俗文化体系,通过十二宫位与星曜组合展现不同的文化象征。相关解读仅供娱乐与文化参考,不构成任何事实判断或人生预测,请勿据此作出重要决策。",
        "十二宫位": {
          "命宫": "命宫在传统文化中象征个人气质与生活态度的起点。该宫位的星曜组合常被用来探讨性格倾向与文化意象,但不代表对实际品格或能力的断言。",
          "兄弟宫": "兄弟宫在传统解读中关联手足情谊与同辈互动模式。文化上常借此思考人际支持网络的多样性,并非判定关系结局的依据。",
          "夫妻宫": "夫妻宫承载着传统婚姻观念的文化表达。它提供的是关于亲密关系互动的开放性思考角度,不能用于保证感情走向或择偶标准。",
          "子女宫": "子女宫在民俗中多与后代缘分和教养理念相关。此处的文化象征意在启发对家庭责任的理解,而非预示生育数量或子女发展。",
          "财帛宫": "财帛宫反映传统文化中对财富观念的探讨。它提示人们关注理财意识与价值取向,但不作为投资决定或财富积累的保证。",
          "疾厄宫": "疾厄宫是传统命理文化中关注身心平衡的象征性领域。需要明确的是,文化解读无法判断身体状况,实际不适应咨询合格专业人员。",
          "迁移宫": "迁移宫在文化意象中常与出行、环境变迁相关联。它鼓励以开放心态面对生活空间的转换,不预示具体的搬迁事件。",
          "交友宫": "交友宫体现了传统文化对社会交往圈层的观察视角。它提醒人们在人际互动中保持真诚与包容,不断言朋友的品格优劣。",
          "事业宫": "事业宫展示了古人对职业发展和人生志向的文化想象。它可作为自我探索的参考主题,但不保证特定职业的成败或晋升。",
          "田宅宫": "田宅宫在传统语境中关乎居住环境与家庭归属感。其文化含义在于强调安居乐业的理念,不预测房产变动或居住条件。",
          "福德宫": "福德宫象征着传统文化对精神世界和内在修养的关注。它引导人们思考如何获得内心的平和,而非衡量福气的大小。",
          "父母宫": "父母宫承载着传统孝道文化与代际沟通的意象。它提供了一个反思亲子关系的视角,不决定家庭互动的最终形态。"
        },
        "主星与辅星": {
          "主星格局": "主星格局是紫微斗数文化中的核心象征框架,不同星曜组合代表着多元的性格侧面与文化寓意。这些格局仅为民俗符号展示,不代表已证实的天文计算事实或个人特质定论。",
          "辅星亮点": "辅星在传统文化中被视为对主星意象的补充与丰富。它们增加了文化解读的层次感,但不应被理解为必然发生的外部助力或阻碍。"
        },
        "四化分析": {
          "化禄": "化禄在文化表达中常象征顺遂与丰盈的意向。它提示人们关注生活中的积极面,但不保证物质财富或现实利益的必然获得。",
          "化权": "化权在传统解读中多与自主意识和行动力相关联。作为一种文化象征,它鼓励主动探索,而非赋予掌控他人的权力或预示职位高低。",
          "化科": "化科的文化意象常指向学习、声誉与和谐。它提醒重视知识积累与人际温和,但不能保证考试结果或社会名望的实现。",
          "化忌": "化忌在民俗中常被视为需要多加留意与沉淀的文化符号。它提示在面对挑战时保持耐心,绝不意味着某种负面事件的必然发生。"
        },
        "大限": [
          {
            "年龄段": "约4至13岁",
            "主题": "启蒙与成长",
            "解读": "这一阶段的文化主题侧重于基础认知的建立与早期环境的适应。在传统解读中,它是探索世界和培养兴趣的时期,而非对个人童年经历的定性。"
          },
          {
            "年龄段": "约14至23岁",
            "主题": "求学与探索",
            "解读": "此阶段的文化意象多与学业发展和自我认同相关。传统观点鼓励在此时期广泛吸收知识,但不以此推断升学结果或青年期的成就。"
          },
          {
            "年龄段": "约24至33岁",
            "主题": "立业与拓展",
            "解读": "进入这一文化阶段,主题转向社会参与和职业方向的初步确立。它提供了一个思考人生规划的视角,不保证事业发展的具体轨迹。"
          }
        ],
        "流年趋势": {
          "近一年": "近一年的文化主题提示关注日常生活中的节奏调整与内心平静。可以将其视为一个重新审视当前目标的契机,而非对近期运势的绝对描述。",
          "近三年": "近三年的文化意象倾向于鼓励持续学习与稳健前行。在这一周期内,传统智慧建议保持开放的心态面对环境变化,不作为长期规划的唯一依据。",
          "提醒": "流年趋势仅为传统文化中随时间推移而变换的思考主题。请选择性地将其作为自我启发的文化问题来探讨,切勿据此要求自己在现实中做出辞职、投资或签约等重要决策。"
        },
        "综合建议": {
          "事业": "事业方面的文化建议在于保持持续学习的态度和对职业方向的独立思考。传统解读仅提供探索思路,请勿据此作出辞职、转行或签署重要合同等现实决策。",
          "财运": "财运相关的文化意象提示树立理性的消费观与长远的财务规划意识。请勿根据本解读作投资决定,所有理财行为应基于专业咨询与个人实际情况。",
          "感情": "感情领域的文化探讨鼓励在关系中注重沟通、尊重与相互理解。不应因生肖、性别或出生资料断言关系结局,也不应将此解读作为择偶或处理情感纠纷的依据。",
          "健康": "文化解读无法判断身体状况,传统命理中的健康意象仅作为一种文化表达存在。如有任何身体不适或健康疑虑,请务必咨询合格的专业医疗人员,切勿依赖文化解读进行自我诊断或改变治疗方案。"
        },
        "免责声明": "以上所有内容均基于紫微斗数等传统文化意象生成,仅供娱乐与文化参考。系统未将任何未核验的星曜位置或命理推断描述为天文计算事实。不得以此为依据预言人生事件、保证准确率与效果,或因出生资料断言个人的品格、能力与命运走向。请勿要求用户根据此解读进行投资、签约、择偶、辞职或其他重要现实决策。健康问题请直接寻求专业医疗帮助。"
      }
    }
  • 鉴权方式

    接口支持以下 AppKey 传递方式,任选一种即可;已有请求示例、Postman 集合和历史代码仍可继续使用原来的 appkey 参数方式。

    传输载体 参数 示例 说明
    HTTP Header X-GUGUDATA-APPKEY X-GUGUDATA-APPKEY: YOUR_APPKEY 推荐方式,适合服务端接入和统一封装。
    HTTP Header X-API-Key X-API-Key: YOUR_APPKEY 通用 API Key Header,便于和常见 API 客户端集成。
    HTTP Header Authorization Authorization: Bearer YOUR_APPKEY 适合 OpenAI 兼容接口或 Bearer Token 风格客户端。
    Query 参数 appkey ?appkey=YOUR_APPKEY 兼容现有示例、Postman 集合、浏览器调试和历史代码。

    部分历史 POST 接口仍兼容表单或 JSON body 中的 appkey;新接入建议优先使用 Header 或 Query 参数。

  • 接口常见 HTTP 响应状态码

    以下为接口调用中常见的 HTTP 传输层状态码,不等同于响应体内的业务状态码;完整状态码注册表以 IANA HTTP Status Code Registry 为准。

    状态码 状态码解释 备注
    200 请求成功 HTTP 请求已成功处理;业务状态请结合响应体中的自定义业务码判断。
    201 资源已创建 创建类接口请求成功,并已生成对应资源。
    202 请求已接受 请求已被接受处理,结果可能异步完成。
    204 无响应内容 请求成功但响应体为空,适用于无需返回数据的操作。
    400 请求参数错误 请求参数缺失、格式错误或参数组合不合法。
    401 认证失败 缺少、无效或未通过认证的访问凭证(如 AppKey)。
    403 无权限访问 订单到期、权限不足或接口额度不可用。
    404 资源不存在 请求路径不存在。
    405 请求方法不允许 当前路径不支持该 HTTP 方法。
    408 请求超时 客户端请求在服务端等待时间内未完成,可稍后重试。
    409 请求冲突 请求与当前资源状态冲突,调整参数或业务状态后重试。
    413 请求内容过大 上传文件或请求体超过接口限制。
    414 请求地址过长 请求 URL 超过服务端可处理长度,建议减少查询参数或改用 POST。
    415 请求内容类型不支持 上传或请求体的内容类型不符合接口要求。
    422 请求语义错误 请求格式正确,但参数取值、语义或业务约束无法处理。
    429 请求频率受限 默认按来源 IP 限速,单 IP 最多 5 QPS,可满足常规业务调用。超出限制时接口会返回 429 请求频率受限;已购买接口订单可加购 10 QPS 扩展。
    431 请求头过大 请求头字段过大或过多,建议精简 Header 后重试。
    500 服务器内部错误 服务端处理异常,请稍后重试。
    502 服务暂时不可用 请稍后重试。
    503 服务暂时不可用 请稍后重试。
    504 请求超时 请稍后重试。
  • 接口自定义业务状态码

    业务状态码 业务状态码解释 备注
    100 请求成功 请同时检查 HTTP 状态、业务码与异步任务状态;任务受理不代表完成。
    501 参数错误 请同时检查 HTTP 状态、业务码与异步任务状态;任务受理不代表完成。
    502 请求频率受限 请同时检查 HTTP 状态、业务码与异步任务状态;任务受理不代表完成。
    503 订单已到期 请同时检查 HTTP 状态、业务码与异步任务状态;任务受理不代表完成。
    504 APPKEY 错误 请同时检查 HTTP 状态、业务码与异步任务状态;任务受理不代表完成。
    505 调用额度耗尽 请同时检查 HTTP 状态、业务码与异步任务状态;任务受理不代表完成。
    -9 处理失败 请同时检查 HTTP 状态、业务码与异步任务状态;任务受理不代表完成。
    901 文化解读暂不可用 请同时检查 HTTP 状态、业务码与异步任务状态;任务受理不代表完成。
  • 请求示例代码

    curl --location --request POST 'https://api.gugudata.com/ai/ziwei-fortune?appkey=YOUR_APPKEY' \
    --header 'Content-Type: application/json' \
    --data '{
      "gender": "女",
      "calendarType": "公历",
      "birthDate": "1990-12-01",
      "birthTime": "07:00",
      "birthPlace": "江苏苏州",
      "isLeapMonth": false,
      "streaming": false,
      "responseMode": "sync"
    }'
    #include <curl/curl.h>
    
    int main(void) {
      CURL *curl = curl_easy_init();
      if (curl) {
        curl_easy_setopt(curl, CURLOPT_URL, "https://api.gugudata.com/ai/ziwei-fortune?appkey=YOUR_APPKEY");
        curl_easy_setopt(curl, CURLOPT_CUSTOMREQUEST, "POST");
        curl_easy_setopt(curl, CURLOPT_FOLLOWLOCATION, 1L);
        struct curl_slist *headers = NULL;
        headers = curl_slist_append(headers, "Content-Type: application/json");
        curl_easy_setopt(curl, CURLOPT_HTTPHEADER, headers);
        curl_easy_setopt(curl, CURLOPT_POSTFIELDS, "{
      \"gender\": \"女\",
      \"calendarType\": \"公历\",
      \"birthDate\": \"1990-12-01\",
      \"birthTime\": \"07:00\",
      \"birthPlace\": \"江苏苏州\",
      \"isLeapMonth\": false,
      \"streaming\": false,
      \"responseMode\": \"sync\"
    }");
        CURLcode res = curl_easy_perform(curl);
        (void)res;
        curl_slist_free_all(headers);
        curl_easy_cleanup(curl);
      }
      return 0;
    }
    
    using System;
    using System.Collections.Generic;
    using System.IO;
    using System.Net.Http;
    using System.Text;
    
    var client = new HttpClient();
    var request = new HttpRequestMessage(HttpMethod.Post, "https://api.gugudata.com/ai/ziwei-fortune?appkey=YOUR_APPKEY");
    request.Content = new StringContent("{
      \"gender\": \"女\",
      \"calendarType\": \"公历\",
      \"birthDate\": \"1990-12-01\",
      \"birthTime\": \"07:00\",
      \"birthPlace\": \"江苏苏州\",
      \"isLeapMonth\": false,
      \"streaming\": false,
      \"responseMode\": \"sync\"
    }", Encoding.UTF8, "application/json");
    var response = client.SendAsync(request).Result;
    Console.WriteLine(response.Content.ReadAsStringAsync().Result);
    
    package main
    
    import (
      "strings"
      "fmt"
      "io"
      "net/http"
    )
    
    func main() {
      url := "https://api.gugudata.com/ai/ziwei-fortune?appkey=YOUR_APPKEY"
      payload := strings.NewReader("{
      \"gender\": \"女\",
      \"calendarType\": \"公历\",
      \"birthDate\": \"1990-12-01\",
      \"birthTime\": \"07:00\",
      \"birthPlace\": \"江苏苏州\",
      \"isLeapMonth\": false,
      \"streaming\": false,
      \"responseMode\": \"sync\"
    }")
      req, err := http.NewRequest("POST", url, payload)
      if err != nil {
        fmt.Println(err)
        return
      }
      req.Header.Add("Content-Type", "application/json")
      res, err := http.DefaultClient.Do(req)
      if err != nil {
        fmt.Println(err)
        return
      }
      defer res.Body.Close()
      body, err := io.ReadAll(res.Body)
      if err != nil {
        fmt.Println(err)
        return
      }
      fmt.Println(string(body))
    }
    
    OkHttpClient client = new OkHttpClient().newBuilder().build();
    MediaType mediaType = MediaType.parse("application/json");
    RequestBody body = RequestBody.create(mediaType, "{
      \"gender\": \"女\",
      \"calendarType\": \"公历\",
      \"birthDate\": \"1990-12-01\",
      \"birthTime\": \"07:00\",
      \"birthPlace\": \"江苏苏州\",
      \"isLeapMonth\": false,
      \"streaming\": false,
      \"responseMode\": \"sync\"
    }");
    Request request = new Request.Builder()
      .url("https://api.gugudata.com/ai/ziwei-fortune?appkey=YOUR_APPKEY")
      .method("POST", body)
      .build();
    Response response = client.newCall(request).execute();
    System.out.println(response.body().string());
    
    $.ajax({
      url: "https://api.gugudata.com/ai/ziwei-fortune?appkey=YOUR_APPKEY",
      method: "POST",
      contentType: "application/json",
      data: JSON.stringify({
      "gender": "女",
      "calendarType": "公历",
      "birthDate": "1990-12-01",
      "birthTime": "07:00",
      "birthPlace": "江苏苏州",
      "isLeapMonth": false,
      "streaming": false,
      "responseMode": "sync"
    }),
    }).done(function (response) {
      console.log(response);
    });
    
    const https = require("node:https");
    const url = "https://api.gugudata.com/ai/ziwei-fortune?appkey=YOUR_APPKEY";
    const body = JSON.stringify({
      "gender": "女",
      "calendarType": "公历",
      "birthDate": "1990-12-01",
      "birthTime": "07:00",
      "birthPlace": "江苏苏州",
      "isLeapMonth": false,
      "streaming": false,
      "responseMode": "sync"
    });
    
    const request = https.request(url, {
      method: "POST",
      headers: {
        "Content-Type": "application/json",
        "Content-Length": Buffer.byteLength(body)
      }
    }, handleResponse);
    request.on("error", console.error);
    request.write(body);
    request.end();
    
    function handleResponse(response) {
      const chunks = [];
      response.on("data", function (chunk) {
        chunks.push(chunk);
      });
      response.on("end", function () {
        console.log(Buffer.concat(chunks).toString("utf8"));
      });
    }
    
    #import <Foundation/Foundation.h>
    
    NSMutableURLRequest *request = [NSMutableURLRequest requestWithURL:[NSURL URLWithString:@"https://api.gugudata.com/ai/ziwei-fortune?appkey=YOUR_APPKEY"]];
    [request setHTTPMethod:@"POST"];
    NSString *body = @"{
      \"gender\": \"女\",
      \"calendarType\": \"公历\",
      \"birthDate\": \"1990-12-01\",
      \"birthTime\": \"07:00\",
      \"birthPlace\": \"江苏苏州\",
      \"isLeapMonth\": false,
      \"streaming\": false,
      \"responseMode\": \"sync\"
    }";
    [request setValue:@"application/json" forHTTPHeaderField:@"Content-Type"];
    [request setHTTPBody:[body dataUsingEncoding:NSUTF8StringEncoding]];
    NSURLSessionDataTask *task = [[NSURLSession sharedSession] dataTaskWithRequest:request completionHandler:^(NSData *data, NSURLResponse *response, NSError *error) {
      if (error) {
        NSLog(@"%@", error);
        return;
      }
      NSLog(@"%@", [[NSString alloc] initWithData:data encoding:NSUTF8StringEncoding]);
    }];
    [task resume];
    
    <?php
    $curl = curl_init();
    curl_setopt_array($curl, array(
      CURLOPT_URL => "https://api.gugudata.com/ai/ziwei-fortune?appkey=YOUR_APPKEY",
      CURLOPT_RETURNTRANSFER => true,
      CURLOPT_FOLLOWLOCATION => true,
      CURLOPT_CUSTOMREQUEST => "POST",
      CURLOPT_POSTFIELDS => "{
      \"gender\": \"女\",
      \"calendarType\": \"公历\",
      \"birthDate\": \"1990-12-01\",
      \"birthTime\": \"07:00\",
      \"birthPlace\": \"江苏苏州\",
      \"isLeapMonth\": false,
      \"streaming\": false,
      \"responseMode\": \"sync\"
    }",
      CURLOPT_HTTPHEADER => array(
        "Content-Type: application/json",
      ),
    ));
    $response = curl_exec($curl);
    curl_close($curl);
    echo $response;
    
    import requests
    import json
    
    url = "https://api.gugudata.com/ai/ziwei-fortune?appkey=YOUR_APPKEY"
    payload = json.loads('{
      "gender": "女",
      "calendarType": "公历",
      "birthDate": "1990-12-01",
      "birthTime": "07:00",
      "birthPlace": "江苏苏州",
      "isLeapMonth": false,
      "streaming": false,
      "responseMode": "sync"
    }')
    response = requests.post(url, json=payload)
    print(response.text)
    
    require "uri"
    require "net/http"
    
    url = URI("https://api.gugudata.com/ai/ziwei-fortune?appkey=YOUR_APPKEY")
    https = Net::HTTP.new(url.host, url.port)
    https.use_ssl = true
    request = Net::HTTP::Post.new(url)
    request["Content-Type"] = "application/json"
    request.body = "{
      \"gender\": \"女\",
      \"calendarType\": \"公历\",
      \"birthDate\": \"1990-12-01\",
      \"birthTime\": \"07:00\",
      \"birthPlace\": \"江苏苏州\",
      \"isLeapMonth\": false,
      \"streaming\": false,
      \"responseMode\": \"sync\"
    }"
    response = https.request(request)
    puts response.read_body
    
    import Foundation
    
    let semaphore = DispatchSemaphore(value: 0)
    var request = URLRequest(url: URL(string: "https://api.gugudata.com/ai/ziwei-fortune?appkey=YOUR_APPKEY")!, timeoutInterval: .infinity)
    request.httpMethod = "POST"
    request.addValue("application/json", forHTTPHeaderField: "Content-Type")
    request.httpBody = "{
      \"gender\": \"女\",
      \"calendarType\": \"公历\",
      \"birthDate\": \"1990-12-01\",
      \"birthTime\": \"07:00\",
      \"birthPlace\": \"江苏苏州\",
      \"isLeapMonth\": false,
      \"streaming\": false,
      \"responseMode\": \"sync\"
    }".data(using: .utf8)
    let task = URLSession.shared.dataTask(with: request) { data, response, error in
      defer { semaphore.signal() }
      guard let data = data else {
        print(String(describing: error))
        return
      }
      print(String(data: data, encoding: .utf8)!)
    }
    task.resume()
    semaphore.wait()
    
  • 常见问题 Q&A

    • Q: 如何完成第一次 API 调用?

      A: 先确认当前接口的请求方法、必填参数和成功状态,再使用对应产品的 AppKey 发起请求;以实际响应中的业务状态判断结果。 查看接入指南

    • Q: 如何保证请求时 AppKey 的安全性?

      A: 在开发者中心的 APP KEY 管理页面复制对应产品的 AppKey,并保存在服务端环境变量或密钥管理服务中。不要写入网页、App 客户端、公开仓库或日志。

    • Q: 接口可以用于哪些开发语言?

      A: Java、Python、Node.js、PHP、Go、C#、Swift、Kotlin 等支持 HTTP 请求的语言均可接入;也可以通过 OpenAPI、Postman 或 Apifox 查看和调试接口。

    • Q: 请求失败或超时后可以重试吗?

      A: 先区分 HTTP 状态与业务错误。参数、鉴权和权限错误应修正后再请求;超时并不表示服务端未执行,重试前需确认接口是否会重复计费或产生副作用。 查看接入指南

    • Q: 接口的性能可以保证吗?

      A: 实际响应时间受接口类型、参数和网络环境影响。请按当前套餐的 QPS 控制并发,生产接入前完成联调与容量评估。

  • 服务协议与免责声明

    购买或使用 GuGuData API 服务前,请充分阅读服务协议、免责声明与数据合规声明。相关页面均支持在浏览器中快速导出 PDF,便于内部归档、评审和合规留存。

  • 技术支持

    技术支持邮箱:
    support@gugudata.com
    企业微信客服:
    联系客服
  • 专业软件开发与系统工程服务

    GuGuData 官方认证工程合作伙伴,专注企业级数据接口集成、AI 工程化与大规模数据处理。团队深度理解 GuGuData 数据接口体系,具备海量数据采集、治理、检索与高并发接口服务经验,可围绕业务场景构建 AI Agent、MCP 接入、智能工作流和生产级数据应用,让数据能力稳定进入现有流程、内部平台和核心业务系统。

    了解工程服务