星座运势

接口说明

按星座名称返回该星座的运势数据，涵盖爱情、事业、财富等运势描述，以及贵人方位、贵人星座、幸运数字、幸运颜色等趣味内容，适合娱乐资讯、内容展示类场景接入。返回内容含有虚构成分，仅供休闲参考，请理性看待、相信科学。

调用地址

/v1/zs_xzys.php

请求方式

支持 GET、POST 两种方式发起请求。

鉴权说明

本接口无需密钥，可直接调用，不区分鉴权方式。

请求参数

参数取值说明：msg 需为十二星座之一，支持中文名称，例如白羊座、金牛座、双子座、巨蟹座、狮子座、处女座、天秤座、天蝎座、射手座、摩羯座、水瓶座、双鱼座；传入简称（如「摩羯」）同样可正常识别。

补充说明：接口无需密钥，免费调用，请求方式支持 GET 与 POST，参数通过查询字符串或表单提交均可。返回内容含贵人方位、贵人星座、幸运数字、幸运颜色及事业、财运、爱情、综合运势等文本信息，其中星座运势内容含有虚构成分，仅供娱乐参考，请注意辨别，相信科学。

成功响应示例

{
  "code": 200,
  "constellation": "摩羯",
  "contentAll": "你与其他异性朋友走的过于亲密，会让爱人发生误会的哦；有时间去做些健身活动，今天久坐易让身体酸痛；沟通与表达能力有待加强，不明确的沟通极易让对方发生理解上的错误。",
  "contentCareer": "事业运不佳，容易产生有苦难言的负面情绪，潜伏着叛逆的态度，宜多控制自己的Eq喔！",
  "contentFortune": "少点物欲，强制存款乃是度过此差运。",
  "contentLove": "会有喜欢的对象出现，可以把握时机。倘若无心谈恋爱，可以与对方交朋友，会比较自然。",
  "direction": "东北方向",
  "friends": "金牛座",
  "lucklyColor": "水晶紫",
  "numbers": 9,
  "shorts": "全心全意得做好自己。",
  "tips": "慕名API：http://xiaoapi.cn"
}

响应字段说明

说明：以上运势内容含虚构成分，仅供娱乐参考，请注意辨别，相信科学。

错误响应示例

当请求未能正常完成业务处理时，接口返回统一结构的 JSON 数据，code 固定为 0，msg 为可读的提示文本，errcode 为业务错误码，可通过该字段判断具体失败原因。

{
  "code": 0,
  "msg": "未提供调用密钥",
  "errcode": 11001
}

{
  "code": 0,
  "msg": "请求过于频繁（QPM 限制）",
  "errcode": 11005
}

星座运势接口本身免费且无需密钥，正常调用不会出现密钥类错误；当传入的星座名称无法识别、请求方式不被允许或服务临时调整时，会返回上述结构，并将 errcode 置为对应业务错误码。

业务错误码说明

星座运势接口为免费接口，正常调用不涉及密钥与积分，但仍可能因请求方式不允许、接口维护、接口不存在或服务暂不可用等原因返回上述错误码，其中较为常见的是 11005、11006、11017 与 11018。

调用示例

终端 curl（bash）

curl -G "https://xiaoapi.cn/v1/zs_xzys.php" \
  --data-urlencode "msg=摩羯座"

PHP

// PHP 示例：GET 请求星座运势
$url = 'https://xiaoapi.cn/v1/zs_xzys.php' . '?' . http_build_query(['msg' => '摩羯座']);
$resp = file_get_contents($url);
$data = json_decode($resp, true);

echo $data['constellation'], "\n";
echo $data['direction'], "\n";
echo $data['lucklyColor'], "\n";
echo $data['numbers'], "\n";
echo $data['contentLove'], "\n";

注意事项

• 本接口无需密钥即可调用，请勿在请求中附带任何密钥类参数，也不必为鉴权失败做额外重试处理。
• 接口为免费调用，但仍建议合理控制请求频率，避免短时间内高频轮询同一星座或批量遍历十二星座；若业务需要多星座数据，可在本地做结果缓存（如按天缓存），既能减少请求压力，也能提升响应速度。
• 星座名称请传入规范中文名，建议带上「座」字（如「摩羯座」），并避免空格、英文名、简称等非预期写法，以免匹配不到数据。
• 返回内容中的运势描述属于娱乐性质，含虚构成分，不应作为健康、投资、情感决策等实际依据。若在应用或页面中展示，建议同时标注「仅供参考娱乐」等提示，避免用户误信。
• 返回结果涵盖整体运势、事业、财富、爱情以及贵人方位、贵人星座、幸运数字、幸运颜色等字段，字段名以实际返回为准，接入前请做好空值兼容判断，部分字段可能不返回或内容为空字符串。
• 接口支持 GET 与 POST 两种请求方式，POST 时请按常规表单方式提交参数；建议使用 HTTPS 调用，防止请求与响应内容在传输过程中被篡改。
• 请勿将本接口的响应内容整体原样搬运至公开内容平台用于流量获利，使用前请自行确认所在场景对数据来源与展示方式的要求。