用途:以编程方式查询 openFDA 公开 API,获取 FDA 监管数据集,用于药物警戒与安全信号筛查、器械法规研究、召回监测、物质身份解析和兽药安全分析。
主要能力:提供统一 Python 接口 FDAQuery,覆盖 drug、device、food、animalandveterinary、other 多个域。便捷方法包括药品不良事件、标签、召回、短缺;器械事件、分类、510(k)、PMA、UDI;食品事件与召回;动物/兽医不良事件;UNII/名称物质查询。支持字段检索、日期范围、通配符、布尔组合等 openFDA 查询语法;count_by_field(...) 聚合(含 .exact);skip/limit 分页与 query_all(...) 批量检索;可选 API key 提升配额,内置 TTL 缓存与限流、基础错误处理。
使用方式:需 Python 3.9+ 及 openFDA 公开 API 访问权限,可选 API key。先配置环境变量 export FDA_API_KEY="your_key_here",再从 scripts.fda_query import FDAQuery,创建实例后调用相应查询方法;示例脚本可运行 python scripts/fda_examples.py。
适用场景:药品安全档案与趋势统计、器械跨库快速检索、食品召回监控、UNII 物质解析等。
限制:未提供具体收费与价格信息;依赖与实现细节以 scripts/fda_query.py 为准,请求依赖如 requests 需自行固定版本;未认证访问配额较低;查询结果需自行处理缺失结果、空集与 API 错误对象。
主要端点:drug/event、drug/label、drug/ndc、drug/enforcement、drug/drugsfda、drug/drugshortages;device/event、device/510k、device/classification、device/enforcement、device/recall、device/pma、device/registrationlisting、device/udi、device/covid19serology;food/event、food/enforcement;animalandveterinary/event;other/substance、other/nsde。