> For the complete documentation index, see [llms.txt](https://doc.duaer.com/zh/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://doc.duaer.com/zh/getting-started/small-bodies.md).

# 在 Duaer 里查小行星与彗星（JPL）

在 Duaer 里：查询 NASA JPL 小天体数据库中的某颗小行星或彗星：轨道、尺寸、自转、反照率以及近地与潜在危险标记。一次成功查询用 1 额度。
## 能拿到什么

Duaer 数据市场里的「小行星与彗星（JPL）」：查询 NASA JPL 小天体数据库中的某颗小行星或彗星：轨道、尺寸、自转、反照率以及近地与潜在危险标记。查到结果时用 1 额度，结果交给数字组织的下一个节点。

从节点创建器选 Duaer 数据 → 小行星与彗星（JPL），或打开 [数据市场](/zh/getting-started/data-market.md)。相关：[小行星近地掠过](/zh/getting-started/close-approaches.md)、[系外行星](/zh/getting-started/exoplanets.md)。

## 适合做什么

- 查某颗小行星的轨道、大小与是否为潜在威胁天体。
- 核对彗星的正式编号。

## 在画布里检索

1. 打开节点创建器，选 Duaer 数据 → Asteroids and comets (JPL)。
2. 填 Asteroid or Comet（如 Apophis）。
3. 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

```
## Questions

### Duaer 的小行星与彗星（JPL）检索扣多少额度？

查到结果时扣 1 额度；没有结果或出错不扣。

### Duaer 小行星与彗星（JPL）名字匹配多个天体怎么办？

Duaer 会每个候选返回一行，只含 designation；用该编号再查一次即可。

## 相关

- [在 Duaer 里查小行星近地掠过](https://doc.duaer.com/zh/getting-started/close-approaches.md)
- [在 Duaer 里查系外行星](https://doc.duaer.com/zh/getting-started/exoplanets.md)