深入解析aqicn token的工作原理与最佳实践

1次阅读

共计 2401 个字符，预计需要花费 7 分钟才能阅读完成。

空气质量数据在现代应用中越来越重要，从健康类 APP 到智能家居系统，都需要实时获取可靠的空气质量信息。AQICN 作为一个广泛使用的空气质量数据提供商，通过 API 接口向开发者提供全球范围内的空气质量数据。然而，直接频繁访问 AQICN 的 API 可能会导致 IP 被封禁或请求被限制，因此引入了 token 机制来管理访问权限。

使用 token 的好处显而易见：

防止滥用 API 资源
提供更稳定的服务质量
便于追踪和管理 API 使用情况
实现细粒度的访问控制

aqicn token 通常是通过注册 AQICN 开发者账号后获得的，每个 token 与一个开发者账号绑定。token 的生成过程涉及以下步骤：

开发者注册并验证账号
系统生成唯一的 token 字符串
token 与开发者信息关联并存储在数据库中
token 被激活并可以用于 API 访问

每次 API 请求时，系统会执行以下验证：

检查 token 是否存在
验证 token 是否有效（未过期 / 未被禁用）
检查 token 的请求频率是否在限制范围内
验证通过后处理请求并返回数据

aqicn token 通常没有严格的有效期限制，但存在以下情况可能导致 token 失效：

开发者主动重置 token
检测到异常使用模式（如高频请求）
系统维护或安全更新

下面是一个 Python 示例，展示如何正确使用 aqicn token 获取空气质量数据：

import requests
import time
from typing import Optional

class AQICNClient:
    def __init__(self, token: str):
        self.token = token
        self.base_url = "https://api.waqi.info"
        self.last_request_time = 0
        self.min_request_interval = 1  # 最小请求间隔 1 秒

    def get_city_feed(self, city: str, max_retries: int = 3) -> Optional[dict]:
        """获取城市空气质量数据"""
        endpoint = f"{self.base_url}/feed/{city}/?token={self.token}"

        for attempt in range(max_retries):
            try:
                # 遵守请求频率限制
                elapsed = time.time() - self.last_request_time
                if elapsed < self.min_request_interval:
                    time.sleep(self.min_request_interval - elapsed)

                response = requests.get(endpoint)
                self.last_request_time = time.time()

                if response.status_code == 200:
                    data = response.json()
                    if data["status"] == "ok":
                        return data["data"]
                    else:
                        print(f"API 返回错误: {data.get('message',' 未知错误 ')}")
                elif response.status_code == 429:
                    print("请求过于频繁，请稍后再试")
                    time.sleep(5)  # 等待 5 秒后重试
                    continue
                else:
                    print(f"请求失败，状态码: {response.status_code}")

            except requests.exceptions.RequestException as e:
                print(f"网络请求异常: {str(e)}")
                time.sleep(2)  # 网络异常等待 2 秒后重试

        return None

# 使用示例
if __name__ == "__main__":
    token = "你的 aqicn_token"
    client = AQICNClient(token)

    # 获取北京空气质量数据
    beijing_aqi = client.get_city_feed("beijing")
    if beijing_aqi:
        print(f"北京当前 AQI: {beijing_aqi.get('aqi',' 无数据 ')}")

aqicn API 对免费 token 有以下限制：