太空数据订阅中心（https://spacemapper.cn/zh-cn/subscription）是太空地图打造的一站式空间目标数据订阅与主动推送服务平台，依托我司天地一体观测网络实测数据以及公共资源轨道综合数据，围绕在轨空间目标提供持续、专业、高价值的空间数据产品。用户选择自己感兴趣的空间目标，即可按需订阅光学追踪报告、碰撞预警报告、全球卫星发射周简报等数据服务。报告可对空间目标开展未来多时段精准轨道推演，提前研判近距离交会与碰撞风险，输出预警等级、碰撞概率、最接近距离、交会时间、相对速度等核心指标，并给出专业风险研判结论，支撑用户快速决策持续跟踪、加密观测或在轨规避准备工作。订阅成功后，平台通过邮箱、API等渠道自动推送报告，实现"一次订阅、持续获取"的便捷体验。

一、订阅服务概览

1. 光学追踪报告

光学追踪报告基于我司自有的天地一体观测网络观测数据，为您提供以下核心能力：

对空间目标实测跟踪与位置比对

评估目标轨道状态与预报精度

评估观测质量与运行稳定性

提供后续观测建议

适用场景：状态确认、预报验证、编目维护、长期监测与态势感知。

2. 碰撞预警报告

碰撞预警报告帮助您在空间目标碰撞风险事件中快速研判、辅助决策，核心能力包括：

对空间目标开展未来多时段推演，提前预判碰撞风险

计算碰撞概率，输出标准化预警等级

提供最接近距离、交会时间与相对速度

自动输出标准化风险分析研判结论

辅助判断运控决策及是否启动规避准备

适用场景：卫星运营、运控值守、空间安全分析与风险评估。

3. 卫星发射周简报

全球卫星发射周简报将为您提供全球航天发射活动的系统性资讯服务：

全球航天发射周度回顾与下周预告

汇总各国/各机构发射任务关键信息

覆盖运载火箭、卫星、载荷与发射场

支持邮件 / API 多渠道推送

适用场景：跟踪全球航天发射活动。

二、如何订阅报告

第一步：进入太空数据订阅中心

登录太空地图平台后，在首页功能区域找到"太空数据订阅"入口卡片，点击进入订阅中心页面。也可以直接访问 https://spacemapper.cn/zh-cn/subscription 进入。

点击图片可放大预览

第二步：选择报告类型并点击"立即订阅"

进入订阅中心页面后，您可以看到平台提供的各类报告服务，包括光学追踪报告、碰撞预警报告（天枢2.0）以及卫星发射周简报（星芒AI·思睿）。找到您需要订阅的报告类型，点击对应的"立即订阅"按钮，即可进入该报告的订阅管理页面。

点击图片可放大预览

第三步：选择目标卫星并点击"订阅"

进入订阅页面后，系统会展示可订阅的卫星列表。如果您尚未激活免费订阅权益，请先点击页面右上角的"激活免费订阅"按钮完成激活。激活后，您可以根据卫星名称、AOE ID 或 NORAD ID 搜索目标卫星，找到需要订阅的卫星后，点击该卫星操作栏中的"订阅"按钮即可。

点击图片可放大预览

第四步：选择订阅方式并确认订阅

点击"订阅"后，系统弹出"订阅卫星"确认弹窗。在弹窗中，您可以选择报告的推送渠道：支持邮箱和API 地址两种方式。选择推送渠道后，在对应输入框中填写您的邮箱地址或 API 地址，最后点击"确认订阅"按钮即可完成订阅。订阅成功后，平台将按照约定周期通过您选择的渠道自动推送报告。（API 方式详见下方"三、订阅产品推送与下载"）。

点击图片可放大预览

三、订阅产品推送与下载

推送订阅产品推送

1. 概述

太空数据订阅支持API 方式推送报告。当订阅的太空数据产生更新时，平台会主动将报告推送到您指定的API地址。

2. 前置准备

2.1 获取 Secret Key

创建订阅后，平台会为您生成唯一的 API密钥，用于 AES-256 加密与解密。您可在订阅中心中查看并复制该密钥，请妥善保管。

获取方式：进入订阅中心，在订阅地址管理模块添加API地址，添加成功后，点击查看即可获取 API密钥，如果已添加过API地址，直接点击查看即可。

注意：API密钥 仅用于推送数据加解密，请勿与 API Token 混淆。API Token 用于接口鉴权，API密钥 用于推送数据加解密。

2.2 配置API地址

您需要提供一个可访问的API地址，平台将向该地址发送 POST 请求推送报告。建议使用 HTTPS 协议以确保传输层安全。

3. 接口规范

POST {您的API地址（API URL）}

请求头部

Header	值	说明
Content-Type	application/json	请求体为 JSON 格式

请求参数

参数名	类型	必填	说明
encry_body	string	是	AES-256 加密后的密文，解密后为 JSON 格式
sendCount	Integer	是	发送次数

encry_body解密后字段描述

字段	类型	说明
dataProductName	String	产品名称
isSupportPull	Boolean	此次发送是否支持文件拉取：true 支持，false 不支持
dataProductUrl	String	产品 URL，即数据产品的访问地址
dataProductPullAddress	String	产品拉取地址，用于主动拉取数据
dataPullHttpMethod	String	产品拉取地址请求方法，如 GET、POST、PUT
verify	Long	校验码，用于判断接口是否被成功调用，如不一致或为空时将重新推送

4. 用户解密与响应

4.1 解密 encry_body

收到推送请求后，使用平台生成的 API密钥 对 encry_body 进行 AES-256 解密。

解密示例（Java）

import javax.crypto.Cipher;
import javax.crypto.spec.SecretKeySpec;
import java.util.Base64;

public static String decrypt(String encryBody, String secretKey) throws Exception {
    SecretKeySpec keySpec = new SecretKeySpec(secretKey.getBytes("UTF-8"), "AES");
    Cipher cipher = Cipher.getInstance("AES/ECB/PKCS5Padding");
    cipher.init(Cipher.DECRYPT_MODE, keySpec);
    byte[] decrypted = cipher.doFinal(Base64.getDecoder().decode(encryBody));
    return new String(decrypted, "UTF-8");
}

String jsonData = decrypt(requestBody.encryBody, "your-API-key");

4.2 解密后数据结构示例

{
  "dataProductName": "报告",
  "isSupportPull": true,
  "dataProductUrl": null,
  "dataProductPullAddress": "https://api.example.com/cgi/dataProduct/push/getDataProductResource/202605/7392846159023743",
  "dataPullHttpMethod": "POST",
  "verify": 7392846159023743
}

4.3 响应 verify 值

解密完成后，从数据中提取 verify 字段，将其作为响应返回给平台。

响应内容

参数名	类型	说明
verify	Integer	解密后数据中的 verify 值，返回给平台

响应示例

{
  "verify": 7392846159023743
}

5. 平台校验

1. 平台发送推送前，记录本次的 verify 。
2. 平台收到您的响应后，获取响应体内容 。
3. 比较 ：
   • verify相同校验通过，推送成功。
   • verify不同校验失败，平台将重新推送。

下载订阅产品下载

用户收到推送后，您可根据解密数据中的 dataProductPullAddress（数据产品报告下载地址）主动拉取报告文件。接口说明如下：

1. 接口规范

POST /dataProduct/push/getDataProductResource/{yyyyMM}/{id}

授权参数

需登录认证（通过 Authorization 请求头）。API TOKEN可通过控制台创建令牌，去控制台创建令牌

请求头部

参数名	说明
Authorization	Bearer {API TOKEN}（如使用 Token 认证）

路径参数

参数名	类型	说明	备注
yyyyMM	string	6位年月	格式：yyyyMM，例如 202607。用于分表路由
id	integer(int64)	记录ID	推送任务记录的唯一标识

响应

成功时直接返回 PDF 文件流，响应头如下：

响应头	值
Content-Type	application/pdf
Content-Disposition	attachment;filename={报告名称}.pdf

错误响应

HTTP 状态码	错误说明
404	任务不存在 / 报告不存在 / 文件不存在 / 文件已删除
400	不支持的数据产品类型 / 文件编码解析失败

2. 响应示例（成功）

二进制 PDF 文件流，浏览器或客户端以附件形式下载。

3. 响应示例（错误 - JSON）

{
  "code": 404,
  "message": "任务不存在/Task not found: id=123, month=202607"
}

{
  "code": 400,
  "message": "暂不支持该数据产品类型/Unsupported data product type: xxx"
}

{
  "code": 404,
  "message": "数据产品资源不存在/data product resource not found"
}