NASA 开放数据源

通过 curl tool 调用 NASA Open APIs 获取天文、近地小行星、火星车照片、太空天气与地球影像等数据。

鉴权

请求 api.nasa.gov 时，在 URL query 携带 API Key：

?api_key={{secrets.NASA_API_KEY}}

占位符由后端在 curl 运行期替换为真实 key，你无需也无法看到明文。不要使用 DEMO_KEY（仅 30 次/小时、50 次/天，会很快触发限流）。

通用约定

• Base URL：https://api.nasa.gov（必须使用 HTTPS，HTTP 会被系统拒绝）
• 请求方法：GET
• 响应格式：JSON
• 日期格式：统一 YYYY-MM-DD
• 分页：仅火星车照片接口分页（page 参数，每页 25 条）；其余接口不分页
• 速率限制：注册 key 为 1000 次/小时，响应头返回 X-RateLimit-Remaining 表示剩余额度
• 调用依赖：
  • 近地小行星 Feed 的 start_date 与 end_date 跨度最多 7 天
  • 火星车照片需先确定 rover 名称（curiosity / opportunity / spirit / perseverance）与 sol（火星日）或 earth_date
  • EPIC 地球影像需两步：先查元数据拿到 image 文件名，再按规则拼出归档图片 URL

⚠️ 速率限制策略（必须遵守）

1. 串行请求：同一时间只发 1 个 curl 请求，等返回后再发下一个。严禁并行发送多个请求
2. 请求间隔：每两个请求之间至少间隔 2 秒
3. 批量查询：近地小行星一次最多查 7 天；火星车照片一次只取 1 页（25 条），如需更多再翻页
4. 429 重试：收到 429（OVER_RATE_LIMIT）后等待 60 秒再重试，严禁立即重试
5. 数据复用：已获取的列表/枚举类结果（如 rover 列表、APOD 内容）应缓存使用，不要重复请求

常用接口

1. 每日天文图（APOD）

GET https://api.nasa.gov/planetary/apod?api_key={{secrets.NASA_API_KEY}}

参数：

关键返回字段：

2. 近地小行星 Feed（NeoWs）

GET https://api.nasa.gov/neo/rest/v1/feed?start_date={{YYYY-MM-DD}}&end_date={{YYYY-MM-DD}}&api_key={{secrets.NASA_API_KEY}}

参数：

关键返回字段：

3. 火星车照片（Mars Rover Photos）

GET https://api.nasa.gov/mars-photos/api/v1/rovers/{rover}/photos?sol={{sol}}&api_key={{secrets.NASA_API_KEY}}

{rover} 取值：curiosity / opportunity / spirit / perseverance。

参数：

* sol 与 earth_date 至少提供其一。

关键返回字段：

4. 太空天气（DONKI）

GET https://api.nasa.gov/DONKI/CME?startDate={{YYYY-MM-DD}}&endDate={{YYYY-MM-DD}}&api_key={{secrets.NASA_API_KEY}}

路径段可替换为不同的太空天气事件类型：CME（日冕物质抛射）、FLR（太阳耀斑）、GST（地磁暴）、SEP、IPS、HSS。各类型参数一致，返回字段略有差异，下表以 CME/FLR/GST 通用字段为例。

参数：

关键返回字段（返回为数组）：

5. 地球影像（EPIC）

GET https://api.nasa.gov/EPIC/api/natural?api_key={{secrets.NASA_API_KEY}}

返回最新一组地球全景图元数据；按日期查询用 https://api.nasa.gov/EPIC/api/natural/date/{{YYYY-MM-DD}}?api_key={{secrets.NASA_API_KEY}}。

关键返回字段：

拼接图片 URL：用元数据中的 date（取年/月/日）和 image 文件名构造：

https://api.nasa.gov/EPIC/archive/natural/{YYYY}/{MM}/{DD}/png/{image}.png?api_key={{secrets.NASA_API_KEY}}

调用示例

场景：用户问「今天的 NASA 每日天文图是什么？」

1. 调用接口：

curl(url = "https://api.nasa.gov/planetary/apod?api_key={{secrets.NASA_API_KEY}}", X = "GET")

2. 从返回中提取 title、explanation、url（media_type 为 image 时附 hdurl），整理成图文回答。

场景：用户问「未来三天有哪些潜在危险的近地小行星？」

1. 计算今天与三天后的日期，调用 Feed 接口：

curl(url = "https://api.nasa.gov/neo/rest/v1/feed?start_date=2026-06-16&end_date=2026-06-19&api_key={{secrets.NASA_API_KEY}}", X = "GET")

2. 遍历 near_earth_objects.{date}[]，筛出 is_potentially_hazardous_asteroid = true 的项，提取 name、estimated_diameter、close_approach_data[0].miss_distance.kilometers 汇总。

错误处理