# 姻缘解析/恋爱解析 · 姻缘解析/恋爱解析

> 本文档为机器可读 Markdown，便于 AI / SDK 自动对接。页面原文：https://www.wapi.cn/api_detail/247/447.html
> 纯文本地址：`https://www.wapi.cn/api_detail/247/447.html?format=md`

## 概览

- **接口名称**：姻缘解析/恋爱解析
- **子接口**：姻缘解析/恋爱解析（ID `447`）
- **接口简介**：根据出生时间，用八字分析在恋爱中的表现、向往，恋人的特点，以及恋爱前期和后期的相处模式
- **计费说明**：按次
- **请求地址**：`https://uaqy.api.storeapi.net/api/247/447`（支持 http/https）
- **请求方式**：`GET,POST`
- **返回格式**：`json,xml`
- **Content-Type（POST）**：`application/x-www-form-urlencoded;charset=utf-8`

## 请求参数

| 名称 | 必填 | 类型 | 说明 | 示例 |
| --- | --- | --- | --- | --- |
| `appid` | 是 | String | 应用ID，在后台我的应用查看或者添加 | 1 |
| `format` | 否 | String | 返回数据格式类型，每个接口已经说明支持返回格式:json,xml, jsonp调用方法说明 | json |
| `gx_birthday` | 是 | String | 生日 | 2024-09-29 16:53 |
| `gx_gender` | 是 | String | 性别：0=女；1=男 | 1 |
| `gx_name` | 是 | String | 名称 | 张三 |
| `sign` | 是 | String | 1.使用Md5方式验证，参数按一定规则md5后返回的字符串，详情点击这里阅读 2.使用Hash验证方式，直接跟上密钥即可。如何设置hash验证 通过我的应用里面修改验证方式 | 52a32be274a5c537bbf7a53e2d66c09f |

## 签名（MD5）

按参数名排序后拼接「键名+值」，空值不参与；末尾直接追加 32 位密钥（密钥不写键名）：

```
sign = MD5(appid1formatjsongx_birthday2024-09-29 16:53gx_gender1gx_name张三{secret})
```

说明：示例中 `appid` 默认为 `1`，请替换为「我的应用」中的 appid；密钥为应用 Secret。

## 返回参数

| 名称 | 必填 | 类型 | 说明 | 示例 |
| --- | --- | --- | --- | --- |
| `codeid` | 否 | Integer | 状态码，返回10000状态都会进行计费。具体说明可查看状态码说明 | 10000 |
| `gx_chapters` | 否 | Array |  |  |
| `gx_text` | 否 | String |  | 2025年4月4日-2025年5月5日 2025年5月5日-2025年6月5日 2026年2月4日-2026年3月5日 2026年3月5日-2026年4月5日 2026年12月7日-2027年1月5日 |
| `gx_title` | 否 | String | 标题 | 相遇 |
| `message` | 否 | String | 请求状态说明 | 返回成功 |
| `retdata` | 否 | Array | 回数据集合,可能是数据、对象或者字符串 |  |

## JSON 返回示例

```json
{
    "codeid": 10000,
    "message": "返回成功",
    "retdata": [
        {
            "gx_chapters": [
                {
                    "gx_text": "您在恋爱中的外在表现可能具有以下特点：\n1. 表现出热情奔放的一面，会主动追求和投入感情，展现出强烈的热情和浪漫的举动。\n2. 善于吸引他人的注意力，能够展现出自信和自我价值。\n3. 在恋爱中表现出坦率和直接的倾向，会直接表达自己的情感和意愿，不喜欢拐弯抹角。\n4. 喜欢冒险和刺激，可能会主动提出一些有趣的约会活动或者旅行计划，给恋爱关系带来新鲜感。\n5. 很擅长制造浪漫场景和惊喜，会为伴侣策划一些浪漫的活动或者送出令人惊喜的礼物。\n总体而言，您在恋爱中会展现出积极、热情和浪漫的一面，注重自我表达和创造情感交流的机会。",
                    "gx_title": "你在恋爱中的表现"
                },
                {
                    "gx_text": "您在恋爱中的内在需求括以下方面：\n1. 希望伴侣充满活力，在恋爱关系中渴望一种热情激烈的恋情，体现出他独特的性格魅力，同时也希望与伴侣一起探索和创造更多的美好时光。\n2. 希望得到伴侣的专注和关注，倾听您的内心，够给予您安全感和信赖，这也是进一步投入恋爱关系的基础。\n3. 需要稳定忠诚的承诺，这样才能够带来安全感和无限温暖。\n4. 喜欢实际行动，也希望伴侣能够积极地给予支持和帮助，共同合作实现爱情的美好。\n5. 也希望在恋爱关系中能够保持自由的个性表现，在这样的关系中不会被束缚和压抑，享受真正的自我。",
                    "gx_title": "你在恋爱中的渴望"
                },
                {
                    "gx_text": "您在恋爱中真正向往的爱情可能是具备以下特点的：\n1 性格热情浪漫，希望在恋爱中能够体验到一段充满激情又浪漫的恋情。\n2.渴望激情，同时也希望在恋爱关系中得到长久而稳定的支持和保障，希望与伴侣能够一起走向未来。\n3. 爱情的基础是忠诚和真实。求一种真心相待的恋爱关系，不求对方非常完美，但希望对方能够真实地表达自己的感受和想法。\n4. 喜欢充满挑战的生活，在爱情关系中也不例外。渴望在恋爱中有一定的挑战和变化，这样才能激发自己的热情和创造力。\n5. 除了身体的吸引和激情，也希望在恋爱中能够找到一种心灵的契合和感性的交流，这样才能够彻底地打开心扉，表达自己的真实感受和渴望。",
                    "gx_title": "你对爱情的真正向往"
                }
            ],
            "gx_title": "恋爱中的你"
        },
        {
            "gx_chapters": [
                {
                    "gx_text": "您在交往的人性格方面可能会表现出慷慨、温和、敏感脆弱、需要关心和关注、寻求安全感、谨慎保守、沟通不畅和容易受到影响等特点。需要和真诚、稳定、温暖、有耐心和善解人意的人交往，发展成稳定和有意义的关系。这种类型的人很容易吸引到您，所以你的恋人性格大多数都是这种性格。",
                    "gx_title": "Ta的性格"
                },
                {
                    "gx_text": "Ta通常会喜欢您几个优点：\n1.  具有积极向上、充满活力的性格。你会用这种热情和活力来吸引对方，让对方感到开心和受到关注。\n2.  具有各种各样的艺术天赋，如音乐、绘画或写作等。这种创造力往往能够吸引对方对您产生兴趣。\n3.  具有幽默和幽默感，能够用幽默化解尴尬和紧张的气氛，给关系注入一份轻松和愉快。这种幽默感往往让Ta觉得自己身边的人生活更加有趣和有活力。",
                    "gx_title": "Ta喜欢你哪些优点"
                }
            ],
            "gx_title": "恋人类型"
        },
        {
            "gx_chapters": [
                {
                    "gx_text": "TA在恋爱中的外在表现有这些：\n1.内心强大，有一颗温柔的心和智慧的头脑，更有一副祥和的外表。\n2.高度自律但又能接受自嘲。\n3.目光柔软但内心潜藏锋芒。",
                    "gx_title": "Ta在恋爱中的表现"
                },
                {
                    "gx_text": "你的那个TA谈恋爱时：\n1. 更关注情感和精神上的满足，可能会更倾向于有性和实际行动的伴侣，以满足TA的需求和增强TA的自信。\n2. TA也需要一个稳定和有安全感的伴侣，以保持情感支持和创造有意义的关系，可以帮助TA保持勇气和信心，一起面对生活的挑战。",
                    "gx_title": "Ta在恋爱中的渴望"
                }
            ],
            "gx_title": "恋爱中的Ta"
        },
        {
            "gx_chapters": [
                {
                    "gx_text": "你第一次见到恋爱对象时，会表现出热情洋溢和外向的特点。在恋爱的初期，通常会表现出自信、积极和充满魅力的态度。可能会主动追求恋爱对象，并积极地展示自己的个性和才华。在相处模式上，你可能会表现出强烈的吸引力和表达爱意的能力，用浓烈的情感和显露的关怀来打动对方。你通常善于传达自己的想法和情感，希望与恋人进行积极的互动和交流。然而，有时候也需要注意控制自己的热情和冲动，给对方留出足够的空间来发展感情。总的来说，在恋爱初期可能会展示出直率、自信和热情洋溢的特质，希望通过热烈的相处模式来建立深厚的恋爱关系。",
                    "gx_title": "初时的恋爱相处模式"
                },
                {
                    "gx_text": "1. 在恋爱中后期，你们可能会犹豫不决，难以表达内心的真实想法和感受。你们倾向于考虑各种可能性，思虑过久可能会让恋爱进度放缓。\n2. 可能会更多地采取等待的态度，希望伴侣主动接近和关注自己。可能会有些自我保护，担心自己的主动有可能会让对方接受不了，从而更加保护心灵，一度会显得矜持。\n3. 可能会容易自我怀疑，并失去信心和勇气， 导致在热恋期进入了相互确认阶段后开始跌落。你们可能会担心自己不能够达到伴侣的期望，或者感觉自己不够好。你们需要相互理解的伴侣让其得到安慰和信心。\n总的来说，你们在恋爱中期可能会表现出犹豫不决、显得被动和缺乏自信的特点，更多的需要接受伴侣的理解和支持，不断增强自我肯定和自我价值感，需要得到伴侣对感情的肯定鼓励，才能进一步开花。",
                    "gx_title": "后期的恋爱相处模式"
                }
            ],
            "gx_title": "相恋相知"
        },
        {
            "gx_chapters": [
                {
                    "gx_text": "2025年4月4日-2025年5月5日\n2025年5月5日-2025年6月5日\n2026年2月4日-2026年3月5日\n2026年3月5日-2026年4月5日\n2026年12月7日-2027年1月5日",
                    "gx_title": "Ta可能出现的时间"
                }
            ],
            "gx_title": "相遇"
        }
    ]
}
```

## 状态码说明

| 状态码 | 说明 |
| --- | --- |
| `10000` | 返回成功 |
| `10001` | appid必须指定，可以我的应用里面查看 |
| `10002` | sign值必须指定，加密规则请前往帮助中心查看 |
| `10003` | sign值验证不通过，加密规则请前往帮助中心查看 |
| `10004` | 时差不能超过10分钟，可以不传递这个参数，注意时间戳单位是秒 |
| `10005` | appid错误，请检查appid值,前往会员中心->我的应用查看或添加 |
| `10006` | 当前IP地址未授权，请前往用户中心->我的应用添加ip{@info} |
| `10007` | 应用被禁用，请联系客服处理 |
| `10008` | 应用内没有该接口，请到我的应用里面添加这个接口 |
| `10009` | api接口不存在 |
| `10010` | 您没有添加该api接口 |
| `10011` | api已经到期 |
| `10012` | 没有订购任何api,请前往购买后再操作 |
| `10013` | 该接口已经暂停使用 |
| `10014` | 未知的错误，可以联系客服处理 |
| `10015` | 参数个数错误 |
| `10019` | {@info} |
| `10017` | time必须是整型 |
| `10018` | 次数不足 |
| `10020` | 子接口不存在,可能已经被关闭 |
| `10021` | 服务器发生错误 |
| `10022` | 帐户余额不足，请充值！ |
| `10023` | 订单提交成功，等待回调结果 |
| `10024` | 调试模式数据 |
| `10025` | 查无数据 |

## 对接提示

1. 先在挖数据（wapi.cn）创建应用，获取 `appid` 与密钥。
2. 按上方参数组装请求，计算 `sign` 后调用接口地址。
3. 可用在线测试工具：`https://www.wapi.cn/api_debug/247/447.html`
