◎AGNSS返回演示管理台 ↗
A SIMPLE GUIDE TO CONNECTION

系统怎么用，BYD 怎么接。

先看懂服务链路，再选择管理操作或系统对接。

京东云 · 单机演示

一张图，看清谁负责什么

账号管理与车端下载，两条独立调用链路

演示已实现待对接
BYD CLOUD

BYD 云端

开通 · 续费 · 取消 · 解绑

订单决定服务权益；取消指定订单后，
旧 Token 失效，其他订单权益按规则保留。
BYD VEHICLE

BYD 车端

客户端证书 ＋ 短期 Token

华大下载服务

检查证书、Token 和有效权益

本演示实现

真实 HDB 上游

取样与时效检查 · 失败即拒发

独立模拟 RTCM

仅验证下载流程 · 不可导航

演示管理台设备维护 · 场景联调 · 故障诊断
待对接：车端 GNSS SDK 注入车端下载后，仍需正式 SDK 完成格式验证和模组注入。当前未实现 HDB 解码，也未验证定位效果。

图中为本演示的逻辑模块，运行于京东云单节点。客户端证书确认受信调用方，设备归属仍由账号、Token及业务权限校验。真实 HDB 和模拟 RTCM 不互相转换；当前没有海外双中心或生产 SLA 验证。

◇

mTLS · 双方核验身份

双方验证受信证书。当前为演示 PKI，尚未完成逐车证书与设备身份绑定。

≋

签名 · 防请求篡改

BYD 云端用应用密钥为业务请求签名，服务端确认内容完整、请求有效。

⌁

Token · 短期通行凭证

车端凭设备账号取得 Token，再携带它下载；过期、取消或解绑会限制访问。

▤

订单 · 记录服务期限

开通和续费形成服务权益；取消按指定订单处理，保留可追踪记录。

第一次使用，做这三步

打开演示管理台 →
1

登录并登记设备

打开管理台，在“设备与订阅”填写编号、类型与月数。默认开通12个月，填0仅登记绑定。

2

跑一次完整流程

进入“场景联调”，运行完整流程，再查看过期、取消等异常场景。场景使用独立演示设备。

3

核对记录与真实数据源

查看订单和诊断日志；在“接口与交付说明”验证真实HDB取样。取样成功不代表导航验收完成。

BYD 开发者：分别对接云端与车端两路使用不同凭据，车端不持有应用签名密钥。
云对云 · 管理服务权益

BYD 云端持有 appKey / appSecret

  1. 领取服务端地址、应用签名凭据、信任CA及云调用方客户端证书；凭据存入受控环境。
  2. 签名调用购买绑定接口，取得设备账号密码，通过安全通道发给对应车端。
  3. 按订单调用激活、续费与取消接口；重复请求沿用业务订单号，同时重新生成签名随机数。
  4. 核对返回有效期、订单冲突与取消结果，保留业务追踪记录。

当前采用演示 HMAC 约定；新材料中的 AK/DSK/AES-GCM 网关协议尚未作为本系统已实现协议。

车端 · 获取星历文件

BYD 车端持有设备账号与客户端证书

  1. 安全保存设备账号密码、客户端证书/私钥及信任CA；不要下发 appSecret。
  2. 通过mTLS连接，用账号密码、deviceId和deviceType换取短期Token。
  3. 将Token放入Authorization请求头，获取真实HDB或独立模拟RTCM；不得把密码或Token放进URL。
  4. 通过 /api/v1/diagnostics 携Token上报诊断；处理过期、取消和网络错误。GNSS SDK与模组注入另行联调。

当前配套 GNSS SDK 与车端注入接口尚待确认，演示下载成功不会自动产生定位能力。

连接地址与证书：管理入口为 /agnss/；独立业务API为 https://agnss-api.chycboard.site。示例客户端按配置直连 111.228.12.162，仍使用原API域名进行严格SNI与证书主机名校验。不要把API域名改成IP，也不要关闭证书校验。凭据通过独立安全渠道交付。演示证书尚未逐车绑定身份，正式证书签发、绑定和轮换需另行确认。
当前演示可调用哪些接口字段、签名和错误码以本系统API文档为准。
云端 POST
/rest/purchase-bind/sik/{sik}

购买并绑定设备；返回设备账号凭据。

云端 POST
/rest/active-renew/sik/{sik}

激活或续费，提交订单号、时长与约定到期日。

云端 POST
/rest/unsubscribe/sik/{sik}

取消指定设备的一笔订阅订单。

车端 POST
/api/v1/token

设备账号换取短期Token；不需要应用签名密钥。

车端 GET
/ephemeris/HD_GPS_BDS_GAL_GLO_QZS.hdb

真实上游HDB；未配置、过期或获取失败时拒发。

车端 GET
/ephemeris/HD_GPS_BDS_GAL_GLO_QZS.rtcm

独立RTCM测试源；合成数据不能用于导航。

通道 GET
/api/v1/time

mTLS校时，返回秒级时间戳；无需HMAC。

云端 POST
/rest/device-status/sik/{sik}

查询设备当前绑定和服务权益，不返回账号密码。

云端 POST
/rest/unbind/sik/{sik}

按请求订单号幂等解绑；旧请求重试不影响之后重绑。

车端 POST
/api/v1/diagnostics

凭Token上报code/message；不能指定其他设备身份。

查看交互式 API 文档 ↗查看 OpenAPI 定义 ↗

交互式文档用于查看契约。业务请求须经独立mTLS入口发送；管理台登录不能替代业务签名或客户端证书。

哪些已经验证，哪些仍待交付避免把“流程跑通”理解为“导航可用”。

当前可操作：设备登记、绑定和订阅，mTLS与请求签名验证，Token签发/撤销，真实HDB取样与下载，独立模拟RTCM下载，以及管理诊断与异常场景。

真实HDB的时效依据：当前两小时拒发策略使用上游HTTP Last-Modified文件更新时间；并未解码卫星星历内部时间，也未证明导航有效期。缓存最长60秒，刷新失败不回退模拟数据。

待双方确认与验证：正式协议和生产凭据体系、GNSS SDK及模组注入、HDB解码和定位效果、海外多区域部署、容量压测及年度SLA。新鉴权网关材料用于评估，不表示本演示已切换协议。