星座配对 - 澄曜API Hub

基本信息

接口调用前需要确认的核心配置。

接口地址/api/constellation_match

请求方式GET,POST

返回格式JSON

调用权限需登录

ApiKey需要

创建时间2026-08-10

脚本路由constellation_match

📊 当前您的权限信息

会员等级

免费用户

调用频率限制

100 次/分钟

可访问API类型

仅免费API

💡 注册成为普通会员可免审核即时获得 Key，调用频率提升至 180 次/分钟。升级VIP 可解锁全部API，调用频率提升至 300 次/分钟。

请求参数说明

必填参数必须传入，示例值可直接用于联调。

参数名	必填	类型	说明	示例值
`key`	是	string	需要审核通过的 ApiKey。请注册账号获取API Key。	`YOUR_API_KEY`
`xingzuo1`	是	string	星座1（一般为男方）。传星座中文名，支持省略“座”字（如“双子”）及异名（天平座/魔羯座/牡羊座/室女座/人马座/宝瓶座）	`双子座`
`xingzuo2`	是	string	星座2（一般为女方）。传星座中文名，支持省略“座”字（如“天秤”）及异名（天平座/魔羯座/牡羊座/室女座/人马座/宝瓶座）	`天秤座`

示例代码

优先使用示例地址测试请求参数是否正确。

示例请求

https://api.ruseo.cn/api/constellation_match?key=YOUR_API_KEY&xingzuo1=%E5%8F%8C%E5%AD%90%E5%BA%A7&xingzuo2=%E5%A4%A9%E7%A7%A4%E5%BA%A7

cURL

curl "https://api.ruseo.cn/api/constellation_match?key=YOUR_API_KEY&xingzuo1=%E5%8F%8C%E5%AD%90%E5%BA%A7&xingzuo2=%E5%A4%A9%E7%A7%A4%E5%BA%A7"

PHP

$url = 'https://api.ruseo.cn/api/constellation_match?key=YOUR_API_KEY&xingzuo1=%E5%8F%8C%E5%AD%90%E5%BA%A7&xingzuo2=%E5%A4%A9%E7%A7%A4%E5%BA%A7';
$response = file_get_contents($url);
$data = json_decode($response, true);

JavaScript

fetch('https://api.ruseo.cn/api/constellation_match?key=YOUR_API_KEY&xingzuo1=%E5%8F%8C%E5%AD%90%E5%BA%A7&xingzuo2=%E5%A4%A9%E7%A7%A4%E5%BA%A7')
  .then(res => res.json())
  .then(data => console.log(data));

返回说明

实际返回内容以接口脚本处理结果为准。

返回示例

{
    "code": 0,
    "msg": "success",
    "data": {
        "route": "constellation_match",
        "example": true
    }
}

返回参数说明

参数名	类型	说明	示例值
`code`	integer	状态码：200 成功，400 失败（参数无效或上游查询失败）	`200`
`msg`	string	提示信息，仅在失败时返回具体原因	`通讯秘钥错误。`
`xingzuo1`	string	星座1（归一化后的标准名称）	`双子座`
`xingzuo2`	string	星座2（归一化后的标准名称）	`天秤座`
`result`	string	整体匹配描述	`天作之合的一对`
`zhishu1`	string	匹配指数，百分制，分值越高整体适配度越高	`100`
`zhishu2`	string	相悦指数，取值 1-5，可自行渲染为星星等符号	`5`
`zhishu3`	string	长久指数，取值 1-5，可自行渲染为星星等符号	`5`
`zhishu4`	string	综合指数，含友情/爱情/婚姻/亲情四项星级，以 \n 分隔，前端需自行替换换行符	`友情：★★★★★\n爱情：★★★★★\n婚姻：★★★★\n亲情：★★★★`
`content1`	string	适配描述1：性格与相处模式分析	`最好的组合就是这种有相同点又有不同点，有立足点相似的思考模式……`
`content2`	string	适配描述2：星座属性与情感发展分析	`双子和秤子都是风象星座，都爱变动，贪新鲜，很自然而然地产生惺惺相惜的感觉……`
`content3`	string	适配描述3：综合评价与相处建议	`Prefect的一对!!! 大家都是风象星座，都是爱变动，贪新鲜……`

调试参数

请求方式接口地址 key * xingzuo1 * xingzuo2 *

响应结果

◔ --

点击左侧“发送请求”查看结果...