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