Interchange 技术栈 · 对外可查

我要接入:三段路,先试用,再签约

这一页只回答三件事:怎么开始、现在能拿到什么、找谁。

一、三段路

段能做什么要签什么怎么退出
① 接洽与授权 把合作范围谈清楚:接哪些国别、接哪种容量、算力怎么算、谁对监管负责。 保密协议;合作意向书(写明范围、期限与是否排他)。 意向书到期自动失效;任一方可书面终止,已交换资料按保密协议处理。
② 测试环境 用样例容量与样例运营主体跑链路,跑完带走一份能自行复算的结果。现状见下一节(如实写)。 在保密协议范围内即可,不需要另签商务合同。 随时退出;测试环境里不放真实容量、真实牌照、真实用户数据。
③ 正式接入 同一套对接方式,把地址与凭证换成正式的即可上线;商务、服务水平与结算周期在这一段落定。 技术服务合同;数据处理条款(数据面本地部署、数据不出境)。 按合同退出条款:数据与资产处置、切换配合、过渡期支持逐项写明。

一句设计口径:测试环境建成后与正式环境用同一套接口——在我们这里跑通的,在正式环境里就通。 这句话是设计承诺,不是「现在已有测试环境」;测试环境的现状见下一节。

二、测试环境现状(如实写)

测试环境(沙箱)在建设中。当前提供的是:离线测试向量三组 + 复算说明 + 一个自测脚本(断网可跑、只用标准库、只算用量不算钱),以及三条已开放接口的对接说明。

现在还没有的东西,逐条列清(不换说法):没有沙箱入口地址、没有自助领凭证的入口、没有在线申请页、没有与正式环境同构的隔离环境。 沙箱建成后,这一格会换成入口地址与凭证申请说明;在那之前,这一格就是这段话。

三、对接方式(一句话版)

三条写接口(都要 Bearer 凭证):

接口路径请求字段回什么
设备注册POST /v1/devices4 格:证书请求、设备指纹、协议版本、能力集激活状态、证书引用、协议版本、响应头
设备心跳POST /v1/devices/{id}/heartbeat3 格:心跳间隔、网络质量、配置协商协商后的间隔、服务端时间、配置是否接受
用量上报POST /v1/billing/events9 格:账单项号、租户、设备、用户、业务类型、数量、金额、币种、发生时刻是否入账、命中的账单项号

三个请求头:链路追踪号(32 位十六进制)、协议版本(形如 1.0)、幂等键(可选,写操作建议给)。 幂等键的用处是一句话说清的:同一个键重复提交,账本不会多记一笔;同一个键换了内容再提交,会被拒。

四、文档位(按需索取,不放在站上)

本站不放这些文件的副本——放了就要维护,维护不动就是死链。所以只列名称与用途,要原件请写信(地址在第七节)。

  • 三条写接口的字段说明:逐格写「填什么、什么类型、必填不必填」,并附各一条完整示例。
  • 算力用量请求的空白表格(8 格):交换号、维度、计量项、单位、数量、起、止、对账粒度。数量一格是十进制整数字符串,写成数字型会被拒——这是金额与数量的硬纪律。
  • 跨维换算登记表:通信 6 种单位 × 算力 5 种单位 = 30 对,逐对给结论:可换算 0 对/不可换算 25 对/待确认 5 对,一对不空。这张表回答「电费能不能折成水费」——今天答案是:不能由平台自己折。
  • 合同「可查材料」清单(六份):边界声明、资产清单、授权链说明、认证委员会名单、公开标准文本、合同模板占位。
  • 对接包说明与字段速查表:接入时手边那一页。

五、测试向量下载位(先自己算一遍)

三组离线向量,断网可打开、可保存。要原件请写信;「应当结论」写在这里,可以先看结论再索取原件自行复算。

  • A 组 · 正确的一条 应当结论:PASS(可复核)——条数、两本合计、整账摘要,三步现算与声明逐位相同。
  • B 组 · 改一个数 应当结论:FAIL(被改过)——点名到第 3 条、点名到「数量」那一栏、并说出原值与现值(1200 → 1201)。
  • C 组 · 截掉一条 应当结论:INCOMPLETE(这一本账不完整)——声明 5 条、实际 4 条,缺的是第 4 条。
  • 复算说明:三步式子、中间量、结论。只用标准库,不装任何东西。
  • 自测脚本:现算三组并打印结论;判断标准是「能不能抓错」,不是「能不能跑通」。

用法:把三份输入与脚本放在同一目录结构下,运行脚本,看它能不能自己得出上面三个结论。 得不出 B 的「点名到条、点名到栏」或 C 的「缺哪一条」,就算这一组没做完——只说「错了」不算结论,对账时要的是「错在哪一格」。

六、三条硬边界(先讲,免得后面扯)

  • 不签发证书、不定义算法:「证书引用」只是台账里的一个引用串;证书算法、密钥长度、签名算法一律「将来由安全侧定」,现在没有。
  • 不算钱:接口只记录你报上来的「用了多少」与「金额原值」,不乘费率、不分段、不出账。分账与出单是另一层,那层的六项商务参数还没确认,所以正式出单现在恒被拦。
  • 不直接服务终端用户:终端合同、资费与服务由各国运营主体提供。我们提供技术与标准,不当门面。

七、一个邮箱位(可直接写信)

接入与材料申请

partners@neutralorbit.com (旁注:已开通,实测已收到信)

这一格现在是可用的收信地址:邮箱已开通,实测已收到信(已实发一封测试信并确认收到)。
材料申请与对接咨询都走上面这个地址;写信时请说明需要哪一份材料、用于什么。
地址已做成可点击的寄信链接:点了就能直接写。

八、你能在多久内看到东西

不设「固定天数」——每一段从双方书面确认起算,因为合规与授权节奏在各国不一样。可以说清的是先后顺序:

  • 先拿到三组离线向量+复算说明:这一步不依赖任何人,你拿到就能自己跑。
  • 再谈三条写接口的对接:地址是现成的(见 接口状态),凭证是手工发的,所以要先有保密协议。
  • 沙箱要等它建成,这一项不给日期;建成之前,本页写「在建设中」。

下一步

接之前先复核:三组向量,自己算一遍。

去「我要复核」→