接口信息

• 接口状态 ： 正常
• 请求方式 ：GET
• 返回格式 ：JSON
• 扣除积分数 ：1

请求地址

https://apigw.caiths.com/api/horoscope

请求参数

参数名	必选	类型	描述
type	是	string	十二星座对应英文小写，aries、taurus、 gemini、 cancer、leo、 virgo、 libra、scorpio、sagittarius、 capricorn、 aquarius、 pisces
time	是	string	今日明日一周等运势,today、 nextday、 week、 month、 year、 love

响应参数

参数名称	类型	描述
code	int	响应码
data.todo.yi	string	宜
data.todo.ji	string	忌
data.fortunetext	object	运势
data.fortunetext.all	string	整体运势
data.fortunetext.love	string	爱情运势
data.fortunetext.work	string	工作运势
data.fortunetext.money	string	财运运势
data.fortunetext.health	string	健康运势
data.fortune.all	int	整体运势评分
data.fortune.love	int	爱情运势评分
data.fortune.work	int	工作运势评分
data.fortune.money	int	财运运势评分
data.fortune.health	int	健康运势评分
data.shortcomment	string	简评
data.luckycolor	string	幸运颜色
data.index	object	各项指数
data.index.all	string	整体指数
data.index.love	string	爱情指数
data.index.work	string	工作指数
data.index.money	string	财运指数
data.index.health	string	健康指数
data.luckynumber	string	幸运数字
data.time	string	日期
data.title	string	星座名称
data.type	string	运势类型
data.luckyconstellation	string	幸运星座
message	string	响应描述

代码示例

注意 🔔️

没有开发者调用凭证无法调用接口哦！！！ 前往获取开发者凭证 (opens new window)

注入Service

@Resource
private ApiService apiService;

• 示例一 ：推荐👍

通过yml配置开发者调用凭证

@GetMapping("/getHoroscope")
public ResultResponse getHoroscope(HoroscopeParams horoscopeParams) {
    ResultResponse horoscope;
    try {
        HoroscopeRequest horoscopeRequest = new HoroscopeRequest();
        horoscopeRequest.setRequestParams(horoscopeParams);
        horoscope = apiService.horoscope(horoscopeRequest);
    } catch (ApiException e) {
        throw new com.qimuu.easyweb.exception.BusinessException(e.getCode(), e.getMessage());
    }
    return horoscope;
}

响应示例：

{
    "todo": {
        "yi": "有话好好说",
        "ji": "过度理想化"
    },
    "fortunetext": {
        "all": "整体运势相对比较好。你可能会感到自己的能力和魅力得到了正面的认可和回报，这会给你带来一些积极的动力和信心。在工作和学习上，你的努力和耐心会得到明显的成果，可能会有一些好的机会和合作伙伴出现。在人际关系方面，你的魅力和亲和力会吸引到更多的人，有助于扩展社交圈子。",
        "love": "单身的与其陷入猜测中，不如勇敢追求自己的感情幸福，大胆迈出一步吧。已有伴者，感情运势较为稳定，与伴侣之间的默契和理解力让你们的关系更加牢固。",
        "work": "通过个人的努力将会获得一些相对应的进展，能够尝到一些小甜头，也会给你一定的鼓舞力量，建议多进行一些新的突破，或能够给你带来意想不到的收获。",
        "money": "财运相对较好，可能会有些额外的收入或意外之财。不过，也要警惕一些小的损耗，比如零散的花费可能会让你不经意间破费。建议你要理性消费，不要过分追求物质享受。",
        "health": "特别留意饮食问题，尽量避免油腻和辛辣食物，保持规律健康的餐饮习惯。另外，定期进行有氧运动和适度的体能锻炼有助于提升体力和循环系统的健康。"
    },
    "fortune": {
        "all": 4,
        "love": 3,
        "work": 4,
        "money": 4,
        "health": 4
    },
    "shortcomment": "不断积累成就感",
    "luckycolor": "绿",
    "index": {
        "all": "83%",
        "love": "75%",
        "work": "80%",
        "money": "88%",
        "health": "85%"
    },
    "luckynumber": "4",
    "time": "9月23日",
    "title": "金牛座",
    "type": "今日运势",
    "luckyconstellation": "天秤座"
}

• 示例二：推荐👍

搭配SwiftWeb (opens new window)快速开发Web项目

@GetMapping("/getHoroscopeEasyWeb")
public BaseResponse<ResultResponse> getHoroscopeEasyWeb(HoroscopeParams horoscopeParams) {
    ResultResponse horoscope;
    try {
        HoroscopeRequest horoscopeRequest = new HoroscopeRequest();
        horoscopeRequest.setRequestParams(horoscopeParams);
        horoscope = apiService.horoscope(horoscopeRequest);
    } catch (ApiException e) {
        throw new com.qimuu.easyweb.exception.BusinessException(e.getCode(), e.getMessage());
    }
    return ResultUtils.success(horoscope);
}

响应示例：

{
  "code": 0,
  "data": {
    "todo": {
      "yi": "开拓视野",
      "ji": "心浮气躁"
    },
    "fortunetext": {
      "all": "整体运势稍微有些起伏，需要警惕横冲直撞的鲁莽行为，以免带来负面的影响。暂时不宜急着做决定，或许有一些卡在前面的难题需要你耗费脑筋进行思考，也可能会一时拿不定主意。当前的你需要思考和调整，才能迈向更好的状态，也要更加理性和成熟地处理人际关系问题。",
      "love": "单身的会觉得很孤独和失落，只是还未是缘分到来的时候而已。已有伴者，可能会出现沟通不畅和误解，建议你多一些耐心和理解，用心去维系你们的感情。",
      "work": "事业和学业可能会比较平淡，可能还要面临一些两难的抉择与考验，建议打醒精神应对，保持灵活应变的准备，不要总是等到问题到来之后才去亡羊补牢。",
      "money": "可能会有一些花费或出现消费需求，但不会带来太大的压力。在购物方面，注意控制自己的欲望不要盲目消费。如果有小的投资机会，可以考虑适当参与，但要做好风险评估。",
      "health": "特别注意保护眼睛和呼吸系统的健康，长期使用电子产品或待在空调房间可能会导致眼睛干涩和不适，适量休息眼睛，多眨眼，用眼保健操缓解眼部疲劳。"
    },
    "fortune": {
      "all": 3,
      "love": 3,
      "work": 2,
      "money": 3,
      "health": 3
    },
    "shortcomment": "进行思考与调整",
    "luckycolor": "蓝",
    "index": {
      "all": "69%",
      "love": "58%",
      "work": "52%",
      "money": "70%",
      "health": "68%"
    },
    "luckynumber": "9",
    "time": "9月23日",
    "title": "双子座",
    "type": "今日运势",
    "luckyconstellation": "巨蟹座"
  },
  "message": "ok"
}

• 示例三：

@GetMapping("/getHoroscope/setKey")
public ResultResponse getHoroscopeSetKey(HoroscopeParams horoscopeParams) {
    ResultResponse horoscope;
    CaiApiClient caiApiClient = new CaiApiClient("7052a8594339a519e0ba5eb04a267a60", "d8d6df60ab209385a09ac796f1dfe3e1");
    try {
        HoroscopeRequest horoscopeRequest = new HoroscopeRequest();
        horoscopeRequest.setRequestParams(horoscopeParams);
        horoscope = apiService.horoscope(caiApiClient, horoscopeRequest);
    } catch (ApiException e) {
        throw new com.qimuu.easyweb.exception.BusinessException(e.getCode(), e.getMessage());
    }
    return horoscope;
}

更多示例详见：Cai-API-SDK-Demo 示例项目 (opens new window)