7 * 24
多渠道服务支持
空间物体API文档
更新时间：2025-02-10 15:30:00
1. 授权参数
Authorization: Bearer {API TOKEN} 其中 {API TOKEN} 是你在控制台创建的API令牌。该 token 在后续的 API 请求中用于身份验证。
2. 空间物体编目数据
GET
https://spacemapper.cn/cgi/obj/cat/api/list请求头部
| 参数名 | 说明 |
|---|---|
| Authorization | Bearer YOUR_API_TOKEN |
请求参数
| 参数名 | 类型 | 说明 | 可选值 |
|---|---|---|---|
| altitude | string | 轨道高度 | GEO, HEO, LEO, MEO |
| catId | integer(int32) | CAT ID | - |
| countryCode | string | 国家代号 | ISO 3166-1 国家代码 |
| inOrbit | integer(int32) | 是否在轨 | 1-在轨，0-不在轨 |
| name | string | 名称 | 支持模糊匹配 |
| noradId | integer(int32) | NORAD ID | 北美防空司令部编目号 |
| objectType | string | 空间物体类型 | 如：PAYLOAD, ROCKET BODY, DEBRIS等 |
| pageIndex | integer(int32) | 页码 | 从1开始 |
| pageSize | integer(int32) | 每页数量 | 默认20，最大100 |
| pageOrder | string | 排序方式 | IN_ORBIT_ASC, IN_ORBIT_DESC |
| source * | string | 数据来源 | AOE, INTL, MIXED |
| status | string | 数据状态 | DRAFT, PUBLISHED, DISABLED, DISCARDED, IN_PROGRESS |
| type | string | 轨道类型 | Elliptical, GTO, IGSO, Molniya, Polar, SSO, Tundra |
响应示例
{
"code": 0,
"message": "success",
"data": {
"total": 150,
"list": [
{
"aoeId": 1001,
"catId": 43867,
"classificationType": "U",
"countryCode": "CN",
"decayDate": "2025-12-31",
"ephemerisType": "SGP4",
"launchDate": "2020-01-15",
"launchSite": "酒泉卫星发射中心",
"launchVehicleId": 201,
"manufacturerId": 301,
"meanElementTheory": "J2",
"missionId": 401,
"name": "EUTE 36D",
"noradId": 59346,
"objectId": "2020-001A",
"objectType": "PAYLOAD",
"orbitCenter": "EARTH",
"orbitType": "GEO",
"orbitalAltitude": "GEO",
"originator": "CNSA",
"rcsSize": "LARGE",
"refFrame": "EME2000",
"source": "AOE",
"status": "PUBLISHED",
"timeSystem": "UTC",
"version": 1,
"vmag": "5.6"
}
]
}
} 响应字段说明
| 字段名 | 类型 | 说明 | 可选值 |
|---|---|---|---|
| aoeId | integer | 对应的AOE ID | - |
| catId | integer | CAT ID | - |
| classificationType | string | 目标类别 | U:公众, S:保留未用, C:保留未用, M:不公开 |
| countryCode | string | 国家代号 | ISO 3166-1 标准 |
| decayDate | string | 陨落时间 | 日期格式: YYYY-MM-DD |
| ephemerisType | string | 星历类型 | SGP4, SDP4, SGP8, SDP8 等 |
| launchDate | string | 发射日期 | 日期格式: YYYY-MM-DD |
| launchSite | string | 发射场 | - |
| launchVehicleId | integer | 发射载具ID | - |
| manufacturerId | integer | 制造商ID | - |
| meanElementTheory | string | 平根理论模型 | J2, J4, FULL 等 |
| missionId | integer | 任务ID | - |
| name | string | 名称 | - |
| noradId | integer | NORAD ID | - |
| objectId | string | 国际编号 | 国际标准格式 |
| objectType | string | 目标类型 | PAYLOAD, ROCKET_BODY, DEBRIS 等 |
| orbitCenter | string | 轨道中心点 | EARTH, MOON, SUN 等 |
| orbitType | string | 轨道类型 | Molniya, Tundra, GTO, IGSO, SSO, Polar, Elliptical |
| orbitalAltitude | string | 轨道高度 | GEO, HEO, LEO, MEO |
| originator | string | 发起人/运营机构 | - |
| rcsSize | string | 雷达截面尺寸 | SMALL, MEDIUM, LARGE |
| refFrame | string | 参考坐标系 | EME2000, TEME, ITRF 等 |
| source | string | 数据来源 | AOE, INTL, MIXED |
| status | string | 数据状态 | DRAFT, PUBLISHED, DISABLED, DISCARDED, IN_PROGRESS |
| timeSystem | string | 时间系统 | UTC, TAI, GPS 等 |
| version | integer | 数据版本号 | - |
| vmag | string | 视星等 | - |
