# 正缘画像 · 正缘画像

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

## 概览

- **接口名称**：正缘画像
- **子接口**：正缘画像（ID `448`）
- **接口简介**：根据出生时间，用八字分析正缘特征，对方在恋爱中有哪些特点，会在恋爱中如何与你相处，和脱单建议，脱单风水布局说明
- **计费说明**：按次
- **请求地址**：`https://uaqy.api.storeapi.net/api/248/448`（支持 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_animal` | 否 | String | 代表动物 | 龙 |
| `gx_乾造` | 否 | String |  | 丙申 |
| `gx_年柱` | 否 | Array |  |  |
| `gx_日柱` | 否 | Array |  |  |
| `gx_时柱` | 否 | Array |  |  |
| `gx_星运` | 否 | String |  | 病 |
| `gx_月柱` | 否 | Array |  |  |
| `gx_神煞` | 否 | Array |  |  |
| `gx_空亡` | 否 | String |  | 辰巳 |
| `gx_纳音` | 否 | String |  | 山下火 |
| `gx_自坐` | 否 | String |  | 病 |
| `gx_藏干` | 否 | Array |  |  |
| `message` | 否 | String | 请求状态说明 | 返回成功 |
| `retdata` | 否 | Array | 回数据集合,可能是数据、对象或者字符串 |  |
| `0` | 否 |  |  | 戊 |
| `gx_bazi` | 否 | Array |  |  |
| `gx_birthday` | 是 | String | 生日 | 2024年09月29日 16时53分 |
| `gx_development` | 否 | String |  | 1. 在恋爱中后期，你们可能会犹豫不决，难以表达内心的真实想法和感受。你们倾向于考虑各种可能性，思虑过久可能会让恋爱进度放缓。 2. 可能会更多地采取等待的态度，希望伴侣主动接近和关注自己。可能会有些自我保护，担心自己的主动有可能会让对方接受不了，从而更加保护心灵，一度会显得矜持。 3. 可能会容易自我怀疑，并失去信心和勇气， 导致在热恋期进入了相互确认阶段后开始跌落。你们可能会担心自己不能够达到伴侣的期望，或者感觉自己不够好。你们需要相互理解的伴侣让其得到安慰和信心。 总的来说，你们在恋爱中期可能会表现出犹豫不决、显得被动和缺乏自信的特点，更多的需要接受伴侣的理解和支持，不断增强自我肯定和自我价值感，需要得到伴侣对感情的肯定鼓励，才能进一步开花。 |
| `gx_early` | 否 | String |  | 你第一次见到恋爱对象时，会表现出热情洋溢和外向的特点。在恋爱的初期，通常会表现出自信、积极和充满魅力的态度。可能会主动追求恋爱对象，并积极地展示自己的个性和才华。在相处模式上，你可能会表现出强烈的吸引力和表达爱意的能力，用浓烈的情感和显露的关怀来打动对方。你通常善于传达自己的想法和情感，希望与恋人进行积极的互动和交流。然而，有时候也需要注意控制自己的热情和冲动，给对方留出足够的空间来发展感情。总的来说，在恋爱初期可能会展示出直率、自信和热情洋溢的特质，希望通过热烈的相处模式来建立深厚的恋爱关系。 |
| `gx_expression` | 否 | String |  | 1. 通常具有仪表堂堂、场强大的特点，在恋爱中也会表现出高贵和自信的一面。 2. 精力旺盛，充满活力，在恋爱中会展现出活力四射、充满魅力的一面。 3. 独立自主、坚定自我，在恋爱中也会表现出追求自由和独立的一面。 4. 具有理智、冷静的特点，在恋爱中会用理性对待问题，不会被情感左右。 5. 通常善于表达自己的情感，真挚动人，会表现出对伴侣深深的爱和关心。 |
| `gx_gender` | 是 | String | 性别：0=女；1=男 | 男 |
| `gx_image` | 否 | String |  | 丹凤眼，这种眼睛形状比较狭长，瞳孔比较小，眼神锐利，透露出一种高傲、自信、冷静的气质。 肤色比较白皙，肤质细腻，给人一种清新的感觉。 五官比较立体清秀，眉目之间流露出一种高傲、优雅的气质。 气质比较高贵，具有优雅、高傲的气质，她们的行为举止也比较得体，给人一种高贵、冷艳的感觉。 |
| `gx_imageurl` | 否 |  |  |  |
| `gx_lunar` | 否 | String |  | 二〇二四年八月廿七 申时 |
| `gx_name` | 是 | String | 名称 | 张三 |
| `gx_report` | 否 | Array |  |  |
| `gx_userinfo` | 否 |  |  |  |
| `gx_wishful` | 否 | String |  | 1. 渴望自由和独立，注重个人空间自主性，希望拥有更多的决策权和自主选择的权利。 2. 具有强烈的成功成就欲和事业心，善于把握机会、积极进取，追求更高的事业目标和成就感。 3.注重自我认同和个人价值，追求专业化、精细化的领域，希望在自己善长和技能范围内得到认同和赞誉。 4. 渴望知识和智慧，喜欢独立思考、自我探索和学习，希望不断提升自己的思维能力和认知水平。 5. 通常个性独特、有个性，希望通过自己独特的特点和个性魅力来赢得他人的认同和赞誉。 |
| `gx_yearning` | 否 | String |  | 1. 在爱情中追求自由和独立。希望与伴侣之间保持个人空间和自主性，不希望被束缚或限制。 2. 渴望与智慧、有对等的伴侣相伴。希望能够与思想、见识相近的人建立深入的情感联系。 3. 希望与伴侣一起成长和进步。追求在爱情中共享彼此的成就、挑战和成长的机会，激励和扶持对方。 4. 在爱情中追求刺激和激情。喜欢与伴侣共同经历新鲜、有趣、令人激动的事情，维持激情和活力。 5. 看重忠诚和稳定。尽管追求自由，但仍希望在爱情关系中建立起坚实的信任和忠诚的基础。 总体而言，您对爱情的真正向往是建立在自由与独立的基础上，追求 |
| `gx_主星` | 否 | String |  | 比肩 |
| `1` | 否 |  |  | 土 |
| `2` | 否 |  |  | 食神 |
| `3` | 否 |  |  | 食 |

## JSON 返回示例

```json
{
    "codeid": 10000,
    "message": "返回成功",
    "retdata": {
        "gx_bazi": {
            "gx_年柱": {
                "gx_乾造": "甲辰",
                "gx_纳音": "覆灯火",
                "gx_空亡": "寅卯",
                "gx_主星": "偏印",
                "gx_藏干": [
                    [
                        "戊",
                        "土",
                        "食神",
                        "食"
                    ],
                    [
                        "乙",
                        "木",
                        "正印",
                        "印"
                    ],
                    [
                        "癸",
                        "水",
                        "正官",
                        "官"
                    ]
                ],
                "gx_星运": "冠带",
                "gx_自坐": "衰",
                "gx_神煞": [
                    "华盖",
                    "空亡"
                ]
            },
            "gx_月柱": {
                "gx_乾造": "癸酉",
                "gx_纳音": "剑锋金",
                "gx_空亡": "戌亥",
                "gx_主星": "正官",
                "gx_藏干": [
                    [
                        "辛",
                        "金",
                        "正财",
                        "财"
                    ]
                ],
                "gx_星运": "死",
                "gx_自坐": "病",
                "gx_神煞": [
                    "天乙贵人",
                    "太极贵人",
                    "桃花"
                ]
            },
            "gx_日柱": {
                "gx_乾造": "丙申",
                "gx_纳音": "山下火",
                "gx_空亡": "辰巳",
                "gx_主星": "元男",
                "gx_藏干": [
                    [
                        "庚",
                        "金",
                        "偏财",
                        "才"
                    ],
                    [
                        "壬",
                        "水",
                        "七杀",
                        "杀"
                    ],
                    [
                        "戊",
                        "土",
                        "食神",
                        "食"
                    ]
                ],
                "gx_星运": "病",
                "gx_自坐": "病",
                "gx_神煞": [
                    "文昌贵人",
                    "天医",
                    "十恶大败"
                ]
            },
            "gx_时柱": {
                "gx_乾造": "丙申",
                "gx_纳音": "山下火",
                "gx_空亡": "辰巳",
                "gx_主星": "比肩",
                "gx_藏干": [
                    [
                        "庚",
                        "金",
                        "偏财",
                        "才"
                    ],
                    [
                        "壬",
                        "水",
                        "七杀",
                        "杀"
                    ],
                    [
                        "戊",
                        "土",
                        "食神",
                        "食"
                    ]
                ],
                "gx_星运": "病",
                "gx_自坐": "病",
                "gx_神煞": [
                    "文昌贵人",
                    "天医"
                ]
            }
        },
        "gx_report": {
            "gx_image": "丹凤眼，这种眼睛形状比较狭长，瞳孔比较小，眼神锐利，透露出一种高傲、自信、冷静的气质。\n肤色比较白皙，肤质细腻，给人一种清新的感觉。\n五官比较立体清秀，眉目之间流露出一种高傲、优雅的气质。\n气质比较高贵，具有优雅、高傲的气质，她们的行为举止也比较得体，给人一种高贵、冷艳的感觉。",
            "gx_wishful": "1. 渴望自由和独立，注重个人空间自主性，希望拥有更多的决策权和自主选择的权利。\n2. 具有强烈的成功成就欲和事业心，善于把握机会、积极进取，追求更高的事业目标和成就感。\n3.注重自我认同和个人价值，追求专业化、精细化的领域，希望在自己善长和技能范围内得到认同和赞誉。\n4. 渴望知识和智慧，喜欢独立思考、自我探索和学习，希望不断提升自己的思维能力和认知水平。\n5. 通常个性独特、有个性，希望通过自己独特的特点和个性魅力来赢得他人的认同和赞誉。",
            "gx_yearning": "1. 在爱情中追求自由和独立。希望与伴侣之间保持个人空间和自主性，不希望被束缚或限制。\n2. 渴望与智慧、有对等的伴侣相伴。希望能够与思想、见识相近的人建立深入的情感联系。\n3. 希望与伴侣一起成长和进步。追求在爱情中共享彼此的成就、挑战和成长的机会，激励和扶持对方。\n4. 在爱情中追求刺激和激情。喜欢与伴侣共同经历新鲜、有趣、令人激动的事情，维持激情和活力。\n5. 看重忠诚和稳定。尽管追求自由，但仍希望在爱情关系中建立起坚实的信任和忠诚的基础。\n总体而言，您对爱情的真正向往是建立在自由与独立的基础上，追求",
            "gx_development": "1. 在恋爱中后期，你们可能会犹豫不决，难以表达内心的真实想法和感受。你们倾向于考虑各种可能性，思虑过久可能会让恋爱进度放缓。\n2. 可能会更多地采取等待的态度，希望伴侣主动接近和关注自己。可能会有些自我保护，担心自己的主动有可能会让对方接受不了，从而更加保护心灵，一度会显得矜持。\n3. 可能会容易自我怀疑，并失去信心和勇气， 导致在热恋期进入了相互确认阶段后开始跌落。你们可能会担心自己不能够达到伴侣的期望，或者感觉自己不够好。你们需要相互理解的伴侣让其得到安慰和信心。\n总的来说，你们在恋爱中期可能会表现出犹豫不决、显得被动和缺乏自信的特点，更多的需要接受伴侣的理解和支持，不断增强自我肯定和自我价值感，需要得到伴侣对感情的肯定鼓励，才能进一步开花。",
            "gx_expression": "1. 通常具有仪表堂堂、场强大的特点，在恋爱中也会表现出高贵和自信的一面。\n2. 精力旺盛，充满活力，在恋爱中会展现出活力四射、充满魅力的一面。\n3. 独立自主、坚定自我，在恋爱中也会表现出追求自由和独立的一面。\n4. 具有理智、冷静的特点，在恋爱中会用理性对待问题，不会被情感左右。\n5. 通常善于表达自己的情感，真挚动人，会表现出对伴侣深深的爱和关心。",
            "gx_early": "你第一次见到恋爱对象时，会表现出热情洋溢和外向的特点。在恋爱的初期，通常会表现出自信、积极和充满魅力的态度。可能会主动追求恋爱对象，并积极地展示自己的个性和才华。在相处模式上，你可能会表现出强烈的吸引力和表达爱意的能力，用浓烈的情感和显露的关怀来打动对方。你通常善于传达自己的想法和情感，希望与恋人进行积极的互动和交流。然而，有时候也需要注意控制自己的热情和冲动，给对方留出足够的空间来发展感情。总的来说，在恋爱初期可能会展示出直率、自信和热情洋溢的特质，希望通过热烈的相处模式来建立深厚的恋爱关系。",
            "gx_imageurl": "https:\/\/oss.zhenlingcn.com\/h5config\/portrait\/0\/8.png"
        },
        "gx_userinfo": {
            "gx_name": "张三",
            "gx_animal": "龙",
            "gx_gender": "男",
            "gx_birthday": "2024年09月29日 16时53分",
            "gx_lunar": "二〇二四年八月廿七 申时"
        }
    }
}
```

## 状态码说明

| 状态码 | 说明 |
| --- | --- |
| `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/248/448.html`