| Header名称 | 默认值 | 必填 | 说明 |
|---|---|---|---|
X-API-Key |
你的API密钥
|
是 | 逗号APIKEY,用户后台首页获取 |
Content-Type |
application/json
|
是 | 请求内容类型 |
| 参数名 | 默认值 | 必填 | 说明 |
|---|---|---|---|
api_id |
72 |
是 | API接口ID,系统默认 |
endpoint_id |
ep_f9c3dabdf499c2f2b9405aff2bf73fc0 |
是 | 端点ID,系统默认 |
method |
POST |
是 | 请求方式,可选值:GET,POST |
| 参数名 | 类型 | 必填 | 说明 | 示例 |
|---|---|---|---|---|
cid |
integer | 是 | 星座 ID,范围 1~12,具体见接口详情对照表 | |
type |
string | 否 | 运势类型:today / tomorrow / week / month / year | |
format |
string | 否 | 返回格式:json(默认)或 txt | |
| 参数名 | 类型 | 说明 | 示例 |
|---|---|---|---|
data.cid |
integer | 星座 ID | |
data.type |
string | 运势类型 | |
data.type_name |
string | 运势类型中文名 | |
data.constellation |
object | 星座基础信息(name/en/icon/date/element/color) | |
data.execution_time |
string | 接口处理耗时(秒) | |
data.fortune |
object | 运势详情,字段随 type 变化,见下方 | |
name |
string | 星座名称 | |
date |
string | 日期(YYYYMMDD) | |
datetime |
string | 日期(中文格式) | |
friend |
string | 速配星座 | |
color |
string | 幸运色 | |
number |
string | 幸运数字 | |
all |
string | 综合指数(0~100) | |
love |
string | 爱情指数 | |
work |
string | 工作指数 | |
money |
string | 财运指数 | |
health |
string | 健康指数 | |
summary |
string | 今日/明日概述 | |
{"success":true,"data":{"cid":1,"type":"today","type_name":"今日运势","constellation":{"name":"白羊座","en":"Aries","icon":"♈","date":"3.21-4.19","element":"火象","color":"#FF6B6B"},"execution_time":0.223,"fortune":{"name":"白羊座","friend":"金牛座","color":"湖蓝","date":"20261013","datetime":"2026年10月13日","health":"73","love":"75","work":"65","money":"90","number":"17","all":"75","summary":"整体运势平稳中带小起伏,多数事务按既定节奏推进,偶有细碎琐事打乱节奏,需及时调整状态回归正轨。评分68"}},"generated_at":"2026-10-13 10:49:09"}
| 错误代码 | HTTP状态 | 错误信息 | 详细说明 |
|---|---|---|---|
400 |
400 | invalid_cid | 星座ID无效 |
400 |
400 | invalid_type | 运势类型无效 |
| 错误代码 | HTTP状态 | 错误信息 | 详细说明 |
|---|---|---|---|
401 | HTTP 401 | 认证失败 | 请求头中缺少 X-API-Key 或 API Key 无效 |
400 | HTTP 400 | 参数错误 | 缺少必要参数(api_id、endpoint_id、method)或必填业务参数缺失 |
404 | HTTP 404 | 资源不存在 | API不存在、已下架或端点不存在 |
403 | HTTP 403 | 未开通 | 您尚未开通此API,请先开通 |
405 | HTTP 405 | 方法不允许 | 请求方法不在端点允许列表中 |
402 | HTTP 402 | 积分不足 | 账户积分不足以调用该API |
500 | HTTP 500 | 服务器内部错误 | 系统异常 |
♈1 白羊座
♉2 金牛座
♊3 双子座
♋4 巨蟹座
♌5 狮子座
♍6 处女座
♎7 天秤座
♏8 天蝎座
♐9 射手座
♑10 摩羯座
♒11 水瓶座
♓12 双鱼座
浙公网安备 33059102000262号