Python调用CDN刷新API前须校验三件事：①请求头含正确认证字段（如Authorization）且签名合规；②使用API专用密钥而非控制台密码；③时间戳为UTC且URL严格编码。
CDN刷新任务不能靠人工点来点去，Python脚本可以稳定触发、带重试、能记录状态——但直接调用厂商API时，401、429、签名过期、URL编码不一致这四类错误占了80%以上的失败原因。
用 requests 调 CDN 刷新接口前必须校验的三件事
多数厂商（阿里云、腾讯云、Cloudflare）要求请求头含 Authorization 或 X-Api-Key，且签名需按特定规则生成。不校验就发请求，大概率拿到 401 Unauthorized 或 403 Forbidden。
- 确认你手里的
access_key_id和access_key_secret是「API专用密钥」，不是控制台登录账号密码 - 检查时间戳是否用 UTC 时间（如阿里云要求
X-Ca-Timestamp为秒级 Unix 时间，误差不能超15分钟） - 对要刷新的 URL 做严格
urllib.parse.quote，比如https://a.com/路径?k=v必须转成https%3A//a.com/%E8%B7%AF%E5%BE%84%3Fk%3Dv，否则返回400 Bad Request
处理 CDN 刷新返回的异步任务 ID 并轮询状态
几乎所有 CDN 厂商的刷新接口都是“提交即返回任务ID”，不等实际刷新完成。直接认为“返回200就成功”是最大误区——任务可能卡在队列里，或被限流拦截。
- 提取响应 JSON 中的
task_id字段（各厂商字段名不同：阿里云叫TaskId，腾讯云叫flowId，Cloudflare 叫id） - 用该 ID 调用查询接口（如阿里云
/2014-11-11/tasks，腾讯云/2022-08-08/task），间隔建议 2–5 秒，最多查 10 次 - 终止条件不是“状态变成 success”，而是
status为success或failed；若查到processing但超时，应记为timeout并告警
避免因并发刷新触发厂商限流（429 Too Many Requests）
单账号每分钟刷新 URL 数量有硬上限（阿里云默认1000条/分钟，腾讯云500条/分钟），脚本无节制并发必然触发 429，且后续请求会被临时封禁几分钟。
立即学习“Python免费学习笔记（深入）”；
- 用
threading.Semaphore或asyncio.Semaphore控制并发数，设为上限值的 70%（例如阿里云设为 700） - 在请求头中加
X-Request-ID: str(uuid.uuid4())，方便在厂商控制台或日志中追踪哪次请求被限流 - 捕获
429响应后，不要立即重试，先time.sleep(1 + random.uniform(0, 2))再继续，避免雪崩
真正难的不是写完脚本能跑通一次，而是它在凌晨三点批量刷新5000个URL时，仍能正确识别 task_id 字段、处理中间网络抖动、把失败项写进日志并通知人——这些细节藏在 retry 逻辑、字段容错和 sleep 策略里，而不是 import 那一行。
