聚合接口文档说明

✨ 聚合接口特性：通过统一地址 + type参数，调用随机颜色、生肖、天气等多种功能，无需记住多个接口地址

接口地址： https://api.qyuan.asia/api/jh

请求方式： GET（简单便捷，直接拼接参数）

请求类型：无特殊要求（浏览器/代码调用均可）

返回格式： JSON（默认，结构统一易解析）

接口用途：聚合随机颜色、数字、生肖、天气等功能，一个接口实现多需求

接口调用规则

<<<

基础地址 <<<	参数拼接格式 <<<	调用示例 <<<	说明
https://api.qyuan.asia/api/jh	?type=参数值	https://api.qyuan.asia/api/jh?type=colour	在基础地址后拼接 `?type=` + 具体参数，即可调用对应功能

type参数详情

<<<

参数名称 <<<	参数类型 <<<	示例值 <<<	参数说明
all	string	—	输出所有功能的返回结果（含颜色、数字、生肖等）
colour	string	#FF5733	返回随机十六进制颜色码（可直接用于UI设计）
number	string	68	返回0-100的随机整数（可用于抽奖、随机选择场景）
zodiac	string	龙	返回十二生肖中的随机一个（含传统生肖名称）
weather	string	晴天	返回随机天气状态（如晴天、雨天、多云等）

请求示例

        // 1. 调用“随机颜色”功能
        https://api.qyuan.asia/api/jh?type=colour

        // 2. 调用“随机生肖”功能
        https://api.qyuan.asia/api/jh?type=zodiac

        // 3. 获取所有功能结果
        https://api.qyuan.asia/api/jh?type=all
    

返回示例

        // 1. type=colour（随机颜色）返回
        {
          "code": 200,
          "msg": "查询成功",
          "data": { "type": "colour", "result": "#2ECC71" }
        }

        // 2. type=all（所有功能）返回
        {
          "code": 200,
          "msg": "查询成功",
          "data": {
            "colour": "#F39C12",
            "number": "45",
            "zodiac": "虎",
            "weather": "多云"
          }
        }
    

返回API首页测试所有聚合功能