核心是“发现变动”而非监控,应保存json schema或关键字段路径快照做结构diff,避免字符串全文比对;需分层校验状态码、响应结构与业务字段,并用apscheduler或cron实现可靠调度。

用 requests 抓取接口响应并比对结构
核心不是“监控”,而是“发现变动”——只要每次请求后保存 JSON Schema 或关键字段路径的快照,下次请求时做结构 diff 就行。别一上来就搞 Webhook 或数据库存历史,先跑通最小闭环。
常见错误是直接字符串比对整个响应体:字段顺序一变、时间戳一刷新、注释一加,就全误报。应该只关注你业务真正依赖的字段层级。
- 用
jsonschema库生成响应的简易 schema(比如只校验data.items[].id是否存在、类型是否为integer),而非比对全文本 - 若接口返回扁平数据,可用
deepdiff.DeepDiff对比两个 dict,但注意设ignore_order=True,否则数组顺序不同就报警 - 对含时间戳或随机 ID 的字段,用正则预处理掉,例如把
"updated_at": "2024-06-12T14:22:33Z"替换为"updated_at": "__TIMESTAMP__"
定时任务别硬写 time.sleep() 循环
本地脚本跑着跑着就卡死、漏检、重复告警,八成是因为用了无限 while True: + sleep。这不是生产级做法,连基础可靠性都没有。
真正能长期跑的方案只有两种:系统级调度(cron)或轻量任务框架(APScheduler)。前者简单粗暴,后者适合需要动态启停或共享状态的场景。
-
cron示例:每 15 分钟执行一次脚本,命令写成*/15 * * * * cd /path/to/script && python check_api.py >> /var/log/api-monitor.log 2>&1 - 用
APScheduler时,必须调用start()后加wait()或配合signal.pause(),否则主进程退出,任务根本不运行 - 避免在任务函数里做耗时操作(如发邮件、写 Excel),失败会阻塞后续轮询;应把告警逻辑异步化或写入队列
HTTP 状态码和重试策略不能只看 200
很多脚本只检查 response.status_code == 200,结果接口返回 200 但 body 是 {"error": "rate limit exceeded"},照样当“正常”处理——这等于没监控。
真正的健康判断要分层:网络层(能否连通)、协议层(状态码是否在预期范围)、业务层(响应体是否含预期字段且不为空)。
- 明确接受的状态码列表,比如
[200, 201, 204],遇到429要退避重试,5xx可记日志但不立即告警(可能只是瞬时故障) - 用
requests.adapters.HTTPAdapter配置重试:设置max_retries=2,并指定Retry(status_forcelist=(429, 500, 502, 503, 504)) - 加个超时兜底:
requests.get(url, timeout=(3.05, 10))—— 第一个数是连接超时,第二个是读取超时,别只写一个数字
告警渠道选错等于白搭
本地打印 print("API changed!") 或弹窗,根本不算告警。得让负责的人真看到、能响应。但也不是越 fancy 越好,微信/钉钉机器人足够覆盖 90% 场景,关键是消息里带可定位信息。
容易被忽略的是上下文缺失:只说“字段变了”,不说“哪个字段、从什么变成什么、发生在哪个 URL”。运维看到这种消息第一反应是翻日志,而不是修问题。
- 钉钉机器人发消息时,把 diff 结果截取关键几行放进
text字段,再附上完整日志链接(比如指向/var/log/api-monitor-20240612.log) - 避免在告警消息里拼接敏感信息(如完整 token、用户手机号),哪怕日志文件权限已设好
- 加个静默开关:比如检测到
ENV=dev就只写日志不发消息,防止测试环境刷屏
实际跑起来最麻烦的不是代码,是字段语义漂移——比如 status 字段昨天是字符串 "active",今天改成整数 1,但文档没更新。这类变动必须靠人肉确认是否兼容,自动化只能帮你“看见”,没法替你“判断”。
大量免费API接口:立即使用
涵盖生活服务API、金融科技API、企业工商API、等相关的API接口服务。免费API接口可安全、合规地连接上下游,为数据API应用能力赋能!











