[TOC] > [參考](https://github.com/fanpei0121/balloons-websocket) # balloons-websocket 用于構建實時應用程序的基礎架構和API，balloons提供了最好的基礎架構和API，以大規模地提供實時體驗。向最終用戶提供快速穩定的實時消息。讓我們處理實時消息傳遞的復雜性，以便您可以專注于代碼。 balloons的實時API向開發人員公開了整個balloons基礎架構，從而可以輕松地以任何規模提供實時功能。無需建立和運營基礎架構，而將精力集中在交付真正重要的功能上。 ## 提供的功能 1. 實現了```/httpPushMessage``` http協議推送消息 2. 實現了```/wsPushMessage``` ws協議推送消息 3. 實現了```/readMessage``` 訂閱頻道 ## 運行 本項目使用Go Mod管理依賴。 ```shell go run main.go ``` ## 依賴 不依賴任何第三方服務，可以直接運行在windows, linux, macos 平臺 ## 使用 **只有同一個app_key并且同一個channel下才會收到消息， 訂閱的readChannel必須和推送消息的writeChannel相同** **sign生成規則：** 1.聲明一個字符串，內容為"000"+當前系統時間戳 2.將Secret key（Secret key 為 .env文件的SECRET_KEY 配置參數）作為秘鑰，用AES算法對字符串進行加密 3.使用Base64對加密結果進行編碼，結果就是sign 4.可以請求http://127.0.0.1:3000/getSign 獲取示例sign **app_key: 應用標識** **writeChannel：推送消息的目標通道** **readChannel： 訂閱消息的目標通道** ### 功能 1. javascript ws方式推送消息 ```shell let sign = encodeURI("VURxMi9KZk9LVW5Dd1pOeTg5cldnVjZyUS95Q3lwMHp4ZXljSE9adnN5cz0="); let ws = new WebSocket("ws://127.0.0.1:3000/wsPushMessage?app_key=my_app&sign="+sign+"&writeChannel=channel01"); ws.send("message"); ``` 2. http推送消息 * 地址：http://127.0.0.1:3000/httpPushMessage * 類型：POST * 狀態碼：200 * 簡介：無 * 請求接口格式： ``` ├─ app_key: String (服務標識) ├─ sign: String (簽名) ├─ writeChannel: String (數據推送的通道) └─ data: String (數據) ``` * 返回接口格式： ``` ├─ code: Number ├─ data: String └─ msg: String ``` 3. javascript 訂閱頻道 ``` let sign = encodeURI("VURxMi9KZk9LVW5Dd1pOeTg5cldnVjZyUS95Q3lwMHp4ZXljSE9adnN5cz0="); let ws = new WebSocket("ws://127.0.0.1:3000/readMessage?app_key=my_app&sign="+sign+"&readChannel=channel01"); ws.onopen = function() { console.log("client：打開連接"); }; ws.onmessage = function(e) { console.log('接受到消息:' + e.data); }; ws.onclose = function(params) { console.log("client：關閉連接"); }; ```