太空碎片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

    请求参数

    参数名 类型 说明 可选值
    source * string 数据源 MIXED(综合编目库,建议使用)
    AOE(AOE catelog库)
    INTL(国际编目库)
    altitude string 轨道高度 GEO, HEO, LEO, MEO
    catId integer(int32) CAT ID 太空碎片ID
    countryCode string 国家代号 参考国家/地区/机构参照表
    inOrbit integer(int32) 是否在轨 0-不限(默认),1-在轨,2-已陨落
    name string 名称 支持模糊匹配
    noradId integer(int32) NORAD ID 北美防空司令部编目号
    objectType string 太空碎片类型 必填 DEBRIS
    pageIndex integer(int32) 页码 从1开始
    pageOrder string 排序方式 入轨时间正序:IN_ORBIT_ASC, 入轨时间倒叙:IN_ORBIT_DESC
    status string 数据状态 PUBLISHED(正式发布的) ; 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": "DEBRIS",
            "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 目标类型 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 视星等 -
    7 * 24小时服务图标

    7 * 24

    多渠道服务支持

    专业服务图标

    专业服务

    云业务全流程支持

    值得信赖图标

    值得信赖

    可以依赖的合作伙伴

    专属贴身服务图标

    专属贴身服务

    1V1贴身服务,专属保障

    建议反馈图标

    建议反馈

    优化建议反馈