入门
在 Duaer 里查小行星与彗星(JPL)
在 Duaer 里:查询 NASA JPL 小天体数据库中的某颗小行星或彗星:轨道、尺寸、自转、反照率以及近地与潜在危险标记。一次成功查询用 1 额度。
能拿到什么
Duaer 数据市场里的「小行星与彗星(JPL)」:查询 NASA JPL 小天体数据库中的某颗小行星或彗星:轨道、尺寸、自转、反照率以及近地与潜在危险标记。查到结果时用 1 额度,结果交给数字组织的下一个节点。
从节点创建器选 Duaer 数据 → 小行星与彗星(JPL),或打开 数据市场。相关:小行星近地掠过、系外行星。
适合做什么
- 查某颗小行星的轨道、大小与是否为潜在威胁天体。
- 核对彗星的正式编号。
在画布里检索
- 打开节点创建器,选 Duaer 数据 → Asteroids and comets (JPL)。
- 填 Asteroid or Comet(如 Apophis)。
- Limit 默认 10,最大 20。执行。
查到结果才扣 1 额度;没有结果、输入有误或上游失败都不扣。
用 API 调用
- GET https://api.duaer.com/v1/data/small-bodies?object=Apophis
- Authorization: Bearer <Duaer key>
下方是与数据市场「复制技能」相同的英文技能,含参数、示例与返回字段。
调用技能(英文)
与数据市场「复制技能」一致。
---
name: duaer-small-bodies
description: >-
Duaer Asteroids and comets (JPL). One asteroid or comet from the NASA JPL Small-Body Database: orbit, size, rotation, albedo, and near-Earth and hazard flags.
One successful search uses 1 Duaer credit.
---
# Duaer Asteroids and comets (JPL)
Duaer Asteroids and comets (JPL) looks up one small body by name, number, or designation. When a name matches several objects, it lists them so you can pick one.
## When to use
- Get the size and orbit of an asteroid such as Apophis.
- Check whether an object is near-Earth or potentially hazardous.
## When not to use
- Upcoming close approaches. Use https://skills.duaer.com/close-approaches.md.
- Planets around other stars. Use https://skills.duaer.com/exoplanets.md.
## Call
`GET https://api.duaer.com/v1/data/small-bodies?object=Apophis`
Header: `Authorization: Bearer <Duaer key>`
Use an account key or a model API key.
Get a Duaer key: https://skills.duaer.com/keys.md
## Parameters
Provide `object`.
- `object` — Name, number, or designation, such as Eros, 433, Apophis, or 1P.
## Examples
- `GET https://api.duaer.com/v1/data/small-bodies?object=Apophis` — asteroid Apophis.
- `GET https://api.duaer.com/v1/data/small-bodies?object=1P` — comet Halley.
## Result
The response is `{ "items": [...] }`. Each item has `source`, `title`, `url`, and `summary`, plus:
- `designation`, `fullName`, `kind`, `orbitClass` — identity and orbit class.
- `nearEarthObject`, `potentiallyHazardous`, `earthMoidAu` — Earth risk flags and minimum orbit distance.
- `diameterKm`, `albedo`, `rotationHours`, `absoluteMagnitude`, `spectralType` — physical data, when measured.
- `semiMajorAxisAu`, `eccentricity`, `inclinationDeg`, `perihelionAu`, `aphelionAu`, `orbitalPeriodDays` — orbit.
Several matches return one row each with `designation` only; call again with that designation.
Fields without a value are left out.
## Credits
A search that returns at least one row uses 1 credit.
An empty search, a search that finds nothing, or a failed search uses 0.
Wrong input returns 400 with a message and uses 0.
No remaining credits returns 402 and does not search.
A missing key returns 401.
## Related
- https://skills.duaer.com/close-approaches.md — Duaer Asteroid close approaches
- https://skills.duaer.com/exoplanets.md — Duaer Exoplanets
常见问题
Duaer 的小行星与彗星(JPL)检索扣多少额度?
查到结果时扣 1 额度;没有结果或出错不扣。
Duaer 小行星与彗星(JPL)名字匹配多个天体怎么办?
Duaer 会每个候选返回一行,只含 designation;用该编号再查一次即可。
同组