推送通知 API 設置
概述
我們提供多個推送 API,允許用戶接收可用的詳細信息,例如庫存情況、發(fā)貨和財務信息。這些 API 可用于客戶自動化流程。要設置推送通知,請執(zhí)行以下操作:
- 登錄 TI.com 后,點擊用戶名稱旁邊的下拉菜單并選擇“myTI 帳戶”。
- 在 myTI 帳戶的左側(cè)導航菜單中,點擊“公司帳戶”下的“API 密鑰和訪問權限”。
- 展開“TI store API 套件”部分。
- 點擊您需要設置的推送 API 旁邊的齒輪圖標。
如何完成此表單
API URL:您的 API URL,該 URL 將接受來自 TI 的 POST 請求。TI API 推送通知將在此處發(fā)送(在創(chuàng)建出貨前通知文檔時的特定屏幕截圖中)。
數(shù)據(jù)格式:在 TI API 發(fā)送的 POST 請求中接收的數(shù)據(jù)格式(JSON 或 XML,如果支持)。默認為 JSON。
身份驗證類型:當調(diào)用您的 API 時,我們支持 2 種身份驗證類型:
- 基本身份驗證(您需要指定用戶名稱和密碼,如下所示)識別特定的用戶。
- 令牌(您為我們提供一個密鑰,TI API 將在特定的標頭中發(fā)送該密鑰)識別特定的應用程序。
API 請求參數(shù):這是一個可選字段,您可以在其中定義 TI API 在調(diào)用您的 API 時將包含的參數(shù)。您可以指定“將日期偏移五天”或“將結果限制為前五個結果”之類的內(nèi)容。
TI 致力于保護您的系統(tǒng)和 TI 免受安全威脅,要求客戶終點滿足啟用 API 回調(diào)功能的特定指導原則。您在 myTI 帳戶中的推送 API 設置以及從 TI 到您指定終點的單獨 API 調(diào)用將受到審核,如果未遵循下述優(yōu)秀實踐,則可能會撤銷對推送 API 的訪問權限。
- 使用具有 SSL 加密和有效證書的 HTTPS webhook URL。
- API 應實施安全方案以限制訪問。優(yōu)先使用令牌身份驗證方法,但如果需要,也支持基本身份驗證。
- 請勿使用動態(tài) DNS、重定向程序、匿名程序或 tor2web 服務。
- 請勿使用攻擊性、濫用性、欺詐性或被禁止的頂級域名。
- 如果可能,您的 API URL 的域應與您的 myTI 客戶域相匹配。
- 請勿使用 IP 地址。
- 請勿使用重定向或中繼 URL 參數(shù)。
- 確保您保存在 myTI API 設置中的終點 URL 允許外部請求。
- 確保您的防火墻允許外部請求。
- 終點應采用 JSON 數(shù)據(jù)格式。
- “API 請求參數(shù)”是可選的,如果您想在對 TI 進行 API 調(diào)用時建立其他設置,則可以使用這些參數(shù)。
審核和批準 API 端點以及保護 API 回調(diào)功能的流程將持續(xù)發(fā)展和改進,我們感謝您的合作。