自定義 API 廣播

引言

到目前為止,您必須為所有客戶聯繫人使用相同的消息進行廣播。 但是,如果您需要為每個客戶提供不同的消息怎麼辦? 例如為不同的人講述特定的信息或某些時間表。

在本指南中,如果您在自己的服務器上擁有自己的客戶數據庫,但您想在此應用程序中使用它們進行廣播,我們將解釋如何執行此操作。

制剂

首先,您必須在自己的服務器上準備 API 的端點,並且您需要一個開發人員/程序員。 但是為了什麼? 它用於允許程序從您的服務器請求廣播數據,並根據您的 API 數據將它們發送給您的客戶。

從我們的服務器查看這個 API 端點示例:https://unlimitedlinebroadcast.com/api/recipients/testopen in new window。 您的 API 響應必須與此類似,才能被此應用程序處理。 這些是您的 API 的要求:

  1. HTTP 請求方法必須在 "GETopen in new window"中
    此端點 https://unlimitedlinebroadcast.com/api/recipients/testopen in new window是一種"GET" 方法。 它應該只包含一個Query Stringsopen in new window 並且只用於請求數據(它不能像"POSTopen in new window"方法中那樣包含數據)。

  2. 響應必須是 JSONopen in new window 字符串
    您的 API 響應必須是原始 JSON 字符串,其中包含兩個根對象:“list”(包含您的廣播數據)和“next”(包含分頁令牌)。 “列表”採用數組的形式,每個列表都包含一個對象,其屬性為“uid”,用於表示客戶的用戶 ID,屬性為“msg”,用於廣播消息。 在下圖中查看我們的示例以了解響應結構。 enter image description here

  3. 請求標頭是可選的
    您的 API 不需要任何額外的 Request Headersopen in new window 用於廣播。 但是,如果您的服務器確實需要其他標頭(例如授權或服務器令牌),我們會為請求標頭提供字段。

  4. 您的 API 必須包含分頁系統
    分頁系統對於您的響應是必要的,以防止我們的服務器和您自己的服務器負載過重。 “list”對象內的數組數據只能包含少於 500 行。 為此,您需要在響應根目錄中包含一個“next”對象。 它必須包含您的下一頁令牌,因此應用程序將使用該令牌加載下一組數據。 如果您的“next”對象為空或 API 響應為空,那麼它會自動表明您的所有數據都已完成並準備好進行廣播處理。

  5. 確保您的服務器代碼運行良好並處於高性能狀態
    如果您的 API 不滿足我們的要求,它會在您的屏幕上彈出警報,您將獲得修復 API 的信息。 如果您覺得自己做得對,但仍有問題,請聯繫我們並解釋您所做的事情,以便我們為您提供幫助。

使用 API 進行廣播

就是這樣! 現在您的 API 已準備好用於廣播。 所以現在我們將給你一個如何在應用程序中使用它的例子。 首先,打開應用程序窗口並將接收者更改為 "From API"。 將您的 API 端點放入端點字段,如果需要,還可以在 headers 字段中放置一些額外的標頭。 請看下面的演示。

如您所見,廣播已完成,消息到達 API 中的所有聯繫人。 如果您在使用此功能時遇到任何困難,請與我們聯繫。