不用每次都去問。先訂閱一支門號,門號一換卡,電信就主動通知銀行系統。
A建立訂閱
電信回覆訂閱建立
銀行訂閱一支門號,並指定接收通知的網址。
B門號換卡
電信通知換卡通知
門號一換卡,電信主動把事件推送到銀行系統。
C訂閱到期
電信通知訂閱結束
訂閱可以設定到期時間或通知次數上限,結束時也會收到通知。
和 SIM Swap 查詢的差別查詢是銀行主動問;訂閱是換卡當下由電信主動告知。
B 與 C通知都送到銀行事先指定的網址。
SIM 卡更換事件訂閱:運作原理
- 建立訂閱銀行送出門號、接收通知的網址,以及事件類型「swapped」。
- 等待事件訂閱生效後,電信持續留意這支門號的換卡紀錄。
- 推送通知門號換卡時推送事件;訂閱到期或達到次數上限時,推送結束通知。
SIM 卡更換事件訂閱:API 規格
規格名稱
SIM Swap Subscriptions(CAMARA 開源規格)
呼叫方式
POST /subscriptions 建立;GET/DELETE /subscriptions/{subscriptionId} 查詢或刪除輸入
protocol(HTTP)、sink 接收網址、types 事件類型、config.subscriptionDetail.phoneNumber 門號訂閱限制
subscriptionExpireTime 到期時間、subscriptionMaxEvents 通知次數上限典型用途
高資產帳戶長期監控換卡,免逐次查詢
| 回覆與事件 | 意思 | 範例 |
|---|---|---|
| id | 訂閱編號 | 1119920371 |
| status | 訂閱狀態:ACTIVATION_REQUESTED、ACTIVE、EXPIRED、INACTIVE、DELETED | ACTIVE |
| swapped 事件 | 門號換卡時推送,內含門號 | …v0.swapped |
| subscription-ended 事件 | 訂閱結束時推送 | …v0.subscription-ended |
三個情境的回覆內容(節錄)
A建立訂閱
id
1119920371訂閱編號status
ACTIVATION_REQUESTED訂閱建立中,生效後為 ACTIVEB門號換卡
type
org.camaraproject.sim-swap-subscriptions.v0.swapped門號換卡事件data.phoneNumber
+886912345678換卡的門號C訂閱到期
type
org.camaraproject.sim-swap-subscriptions.v0.subscription-ended訂閱結束通知規格來源:CAMARA SimSwap r3.3(SIM Swap Subscriptions v0.3.0)