package shop.alien.api.feign;

import com.alibaba.fastjson.JSONObject;
import org.springframework.cloud.openfeign.FeignClient;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.PathVariable;
import org.springframework.web.bind.annotation.RequestParam;

/**
 * 和风空气质量
 *
 * @author ssk
 * @version 1.0
 * @date 2025/3/17 16:28
 */
@FeignClient(url = "https://devapi.qweather.com/airquality/v1", name = "heFengAirQualityApi")
public interface QWeatherAirQualityFeign {

    /**
     * 空气质量
     *
     * @param key       和风天气密钥
     * @param lang      多语言设置，请阅读多语言文档，了解我们的多语言是如何工作、如何设置以及数据是否支持多语言。
     * @param current   current:实时, hourly: 每小时, daily: 每日
     * @param longitude (必选)所需位置的经度。十进制，最多支持小数点后两位。例如 116.41
     * @param latitude  (必选)所需位置的纬度。十进制，最多支持小数点后两位。例如 39.92
     * @return https://dev.qweather.com/docs/api/air-quality/
     */
    @GetMapping(value = "/{current}/{latitude}/{longitude}")
    JSONObject airQuality(
            @RequestParam(value = "key") String key,
            @RequestParam(value = "lang") String lang,
            @PathVariable(value = "current") String current,
            @PathVariable(value = "longitude") String longitude,
            @PathVariable(value = "latitude") String latitude
    );


}
