合作方、報文和對賬, 在同一套接口台上看完
遇碳雲互聯互通接口管理系統把合作方、協議目錄、聯調、四向報文和對賬差異放在同一本台賬。對方推來的狀態和訂單報文可以檢索,推不出去的進入隊列重試。充電訂單、樁和發票在充電運營,車場訂單在智慧停車,設備物模型在 IoT。
- 協議目錄
- 公共、業務、交易與監管
- 四向報文
- 推我、調我、我調、我推
- 聯調調試
- 收包、出包和簽名工具
- 對賬差異
- 有差異不寫成已結清
- 對方推我38%
- 對方調我22%
- 我調對方24%
- 我推對方16%
- 星星充電推送待重試待重試
- 昨日訂單報文有差異有差異
從合作方到對賬差異
先有合作方和協議目錄,再聯調收發包,報文進中心,對賬只標差異,可觀測和場景擴展引用同一本賬。
- 01
建合作方
登記運營商或平台,打開要用的接口,並寫上限流。
合作方 - 02
對協議目錄
按公共信息、業務信息、交易信息、憑證、擴展域和監管上報對照接口。
協議接口目錄 - 03
聯調收發包
聯調嚮導、收包調試台和出包調試台打通一筆樣例。簽名工具只用於聯調。
接入與聯調 - 04
報文進中心
對方推我、對方調我、我調對方、我推對方分開檢索。推送失敗進入隊列。
報文中心 - 05
對賬看差異
訂單與賬單報文和平台訂單對照。有差異單獨列出,不寫成已結清。
交易與對賬 - 06
可觀測與場景
可用率和告警看接口是否穩定。場站開放、監管上報和二輪協議放在場景擴展。
可觀測 · 場景
按接入生命週期逐項看
工作台在頁首。下面八項對應協議目錄、合作方、字典、聯調、報文、可觀測、對賬和場景擴展。
協議接口目錄
目錄與合作方按標準分層看接口。目錄説明每一層管什麼,聯調時按層打開開關。
- 六層分開,不把監管上報和交易信息混成一張表
- 出處寫在分層説明裏
- 開關仍在合作方上配置
示意卡片裏的報文量和差異條數用於説明版面,不代表某個合作方的結算結果。
合作方、報文和對賬各看各的標記
已停用的合作方不再應答。驗籤失敗和待重試不寫成已成功。對賬有差異時不寫成已結清。
合作方
這家平台現在能不能收發。
- 只用調試台和樣例聯調中聯調中
- 已打開的接口可以收發已上線已上線
- 不再應答,也不再推送已停用已停用
報文
這一筆報文走到哪一步。
- 簽名與解密通過後落庫驗籤通過通過
- 不寫成已接收驗籤失敗失敗
- 推送失敗留在隊列待重試待重試
對賬
報文和平台訂單是否對得上。
- 訂單與賬單報文能對上一致一致
- 列出差額,不標成已結清有差異有差異
8 個狀態接口開關、限流和密鑰在合作方檔案裏維護。資金是否到賬以充電運營和支付渠道的結果為準。
接入、聯調、值班、對賬和報送各看不同的頁
同一本接口賬,有人管合作方,有人打樣例,有人看報文,有人核對差異。
現在有幾家已上線,還有誰停在聯調,哪些接口沒打開?
- 工作台上的在網合作方
- 合作方狀態
- 接口開關
看工作台、跑聯調、再標差異
一次接入從工作台開始,到告警或報送記錄結束。中間每一步都能回到合作方和報文。
- 1看工作台
在網合作方和待處理決定要不要下鑽。
- 2對目錄
確認這一層接口在目錄裏,並在合作方打開。
- 3跑聯調
用調試台打通一筆收包和一筆出包。
- 4收報文
按方向檢索,驗籤失敗和待重試分開。
- 5標對賬差異
對不上的訂單報文單獨列出。
- 6告警或報送
可用率告警,或監管上報留下記錄。
接口台賬留在這裏
合作方、目錄、聯調、報文、對賬差異和場景擴展在互聯互通接口管理系統。訂單、設備和資金各自有產品。
本產品負責
- 協議接口目錄和字典規範
- 合作方檔案、接口開關與限流
- 聯調嚮導、收包調試台、出包調試台、簽名工具
- 四向報文和推送隊列
- 訂單與賬單報文、對賬差異
- 可用率、告警、場站開放、監管上報和二輪協議
資金劃轉、錢包入賬和官方監管回執不在本頁完成。對賬差異只説明報文和平台訂單對不上,不代表已收款或已退款。
五步把一家合作方接上
先有檔案和開關,再用調試台打通收包和出包,然後報文能檢索,對賬能看出差異。
- 1合作方名稱、地址和密鑰
- 2要打開的接口清單
- 3一筆可打樣的站點或訂單
- 4對賬要對照的平台訂單範圍
聯調樣例不寫入正式對賬。驗籤沒通過的報文不寫成已接收。
- 1建合作方
錄入運營商或平台,狀態先放在聯調中。
完成標誌 · 檔案可打開 - 2打開接口開關
按目錄勾選接口,並寫上限流。
完成標誌 · 開關已保存 - 3打通收包和出包
調試台各走一筆樣例,簽名工具只輔助聯調。
完成標誌 · 樣例可回放 - 4報文可檢索
四個方向和推送隊列都能按合作方查到。
完成標誌 · 中心有記錄 - 5對賬能看差異
用一筆平台訂單對照報文,差異單獨列出。
完成標誌 · 差異可打開
多合作方、留痕、可導出
同一套接口台按合作方分開。開關、限流、報文和報送都留下記錄。部署方式與價格見定價頁。
每家運營商或平台單獨檔案、開關和限流。
調用頻率寫在合作方上。簽名與加解密工具服務聯調。
報文、驗簽結果、重試和報送保留記錄。
按合作方和時間導出報文與對賬差異。
按項目開通,與遇碳雲充電、停車產品同一賬號體系。
密鑰和報文只能留在內網時,平台可部署在客户側。
汽車互聯、二輪、監管和場站開放都能落在這本賬上
主鏈路是合作方和報文。場景擴展承接場站開放、監管上報和二輪協議。
報文、訂單和設備協議
下面五件是開通前最常核對的口徑。
和充電運營怎麼分工?
充電訂單、樁、電價和發票在充電運營。本頁保留合作方報文、推送隊列和對賬差異。兩邊可以按訂單號對照,不合併成一張賬單。
和 IoT 怎麼分工?
樁和表計的物模型、MQTT 等設備協議在 IoT。本頁是與運營商、平台之間的 HTTP 互聯:目錄、簽名、報文和對賬差異。
對賬差異等於已收款嗎?
對賬差異只説明報文和平台訂單對不上。已收款、已退款以充電運營和支付渠道的結果為準。本頁不把差異標成已結清。
監管上報等於主管部門已接收嗎?
本頁留下組包和報送記錄。主管部門是否接收、是否回執,以對方系統為準。沒有回執時不寫成已通過。
簽名工具能代替對方正式環境嗎?
簽名與加解密工具只服務聯調樣例。正式收發走已上線合作方打開的接口,樣例報文不進入正式對賬。