我要接入:三段路,先试用,再签约
这一页只回答三件事:怎么开始、现在能拿到什么、找谁。
一、三段路
| 段 | 能做什么 | 要签什么 | 怎么退出 |
|---|---|---|---|
| ① 接洽与授权 | 把合作范围谈清楚:接哪些国别、接哪种容量、算力怎么算、谁对监管负责。 | 保密协议;合作意向书(写明范围、期限与是否排他)。 | 意向书到期自动失效;任一方可书面终止,已交换资料按保密协议处理。 |
| ② 测试环境 | 用样例容量与样例运营主体跑链路,跑完带走一份能自行复算的结果。现状见下一节(如实写)。 | 在保密协议范围内即可,不需要另签商务合同。 | 随时退出;测试环境里不放真实容量、真实牌照、真实用户数据。 |
| ③ 正式接入 | 同一套对接方式,把地址与凭证换成正式的即可上线;商务、服务水平与结算周期在这一段落定。 | 技术服务合同;数据处理条款(数据面本地部署、数据不出境)。 | 按合同退出条款:数据与资产处置、切换配合、过渡期支持逐项写明。 |
二、测试环境现状(如实写)
测试环境(沙箱)在建设中。当前提供的是:离线测试向量三组 + 复算说明 + 一个自测脚本(断网可跑、只用标准库、只算用量不算钱),以及三条已开放接口的对接说明。
现在还没有的东西,逐条列清(不换说法):没有沙箱入口地址、没有自助领凭证的入口、没有在线申请页、没有与正式环境同构的隔离环境。 沙箱建成后,这一格会换成入口地址与凭证申请说明;在那之前,这一格就是这段话。
三、对接方式(一句话版)
三条写接口(都要 Bearer 凭证):
| 接口 | 路径 | 请求字段 | 回什么 |
|---|---|---|---|
| 设备注册 | POST /v1/devices | 4 格:证书请求、设备指纹、协议版本、能力集 | 激活状态、证书引用、协议版本、响应头 |
| 设备心跳 | POST /v1/devices/{id}/heartbeat | 3 格:心跳间隔、网络质量、配置协商 | 协商后的间隔、服务端时间、配置是否接受 |
| 用量上报 | POST /v1/billing/events | 9 格:账单项号、租户、设备、用户、业务类型、数量、金额、币种、发生时刻 | 是否入账、命中的账单项号 |
三个请求头:链路追踪号(32 位十六进制)、协议版本(形如 1.0)、幂等键(可选,写操作建议给)。
幂等键的用处是一句话说清的:同一个键重复提交,账本不会多记一笔;同一个键换了内容再提交,会被拒。
四、文档位(按需索取,不放在站上)
- 三条写接口的字段说明:逐格写「填什么、什么类型、必填不必填」,并附各一条完整示例。
- 算力用量请求的空白表格(8 格):交换号、维度、计量项、单位、数量、起、止、对账粒度。数量一格是十进制整数字符串,写成数字型会被拒——这是金额与数量的硬纪律。
- 跨维换算登记表:通信 6 种单位 × 算力 5 种单位 = 30 对,逐对给结论:可换算 0 对/不可换算 25 对/待确认 5 对,一对不空。这张表回答「电费能不能折成水费」——今天答案是:不能由平台自己折。
- 合同「可查材料」清单(六份):边界声明、资产清单、授权链说明、认证委员会名单、公开标准文本、合同模板占位。
- 对接包说明与字段速查表:接入时手边那一页。
五、测试向量下载位(先自己算一遍)
- A 组 · 正确的一条 应当结论:PASS(可复核)——条数、两本合计、整账摘要,三步现算与声明逐位相同。
- B 组 · 改一个数 应当结论:FAIL(被改过)——点名到第 3 条、点名到「数量」那一栏、并说出原值与现值(1200 → 1201)。
- C 组 · 截掉一条 应当结论:INCOMPLETE(这一本账不完整)——声明 5 条、实际 4 条,缺的是第 4 条。
- 复算说明:三步式子、中间量、结论。只用标准库,不装任何东西。
- 自测脚本:现算三组并打印结论;判断标准是「能不能抓错」,不是「能不能跑通」。
六、三条硬边界(先讲,免得后面扯)
- 不签发证书、不定义算法:「证书引用」只是台账里的一个引用串;证书算法、密钥长度、签名算法一律「将来由安全侧定」,现在没有。
- 不算钱:接口只记录你报上来的「用了多少」与「金额原值」,不乘费率、不分段、不出账。分账与出单是另一层,那层的六项商务参数还没确认,所以正式出单现在恒被拦。
- 不直接服务终端用户:终端合同、资费与服务由各国运营主体提供。我们提供技术与标准,不当门面。
七、一个邮箱位(可直接写信)
接入与材料申请
八、你能在多久内看到东西
不设「固定天数」——每一段从双方书面确认起算,因为合规与授权节奏在各国不一样。可以说清的是先后顺序:
- 先拿到三组离线向量+复算说明:这一步不依赖任何人,你拿到就能自己跑。
- 再谈三条写接口的对接:地址是现成的(见 接口状态),凭证是手工发的,所以要先有保密协议。
- 沙箱要等它建成,这一项不给日期;建成之前,本页写「在建设中」。