摘要
本文旨在協助您解決在使用 Astra 中的 REST API 動作時可能遇到的常見問題。涵蓋範圍包括常見問題，例如遺漏表單參數、潛在客戶資料的限制、驗證錯誤，以及重要的安全性考量，以確保您的整合可靠運作。
說明
表單已提交：參數未傳送
問題
當提交自訂表單時，您的 REST API 會收到空白或遺漏的值。
發生原因
這通常發生在 REST API 設定中使用的預留位置與表單欄位名稱不完全符合時。
比對時是區分大小寫的，並且是根據預留位置的尾碼（最後一個.之後的部分）進行的。
如何解決
請確保預留位置的尾碼與您的表單欄位名稱完全相符。
範例：
表單欄位
first_name→ 預留位置{{first_name}}或{{contact.first_name}}✅表單欄位
firstName→ 預留位置{{contact.first_name}}❌原因：大小寫不符（
firstName≠first_name）
修正預留位置後，請儲存動作並再次進行測試。
潛在客戶已擷取：自訂欄位無法運作
問題
您希望在潛在客戶已擷取事件中傳送額外或自訂欄位。
發生原因
潛在客戶已擷取事件一律會傳送固定結構的請求內文。此事件類型不支援自訂欄位。
任何自訂的 request_body 設定都會被忽略。
替代方案
如果您需要傳送自訂資料，請使用下列其中一個選項：
使用自訂表單的表單已提交事件
使用可自訂請求內文的意圖式觸發條件
這些選項可讓您精確控制要傳送至 API 的資料。
驗證錯誤
問題
您的 API 會傳回 401 Unauthorized 錯誤。
如何解決
確認您的 API 金鑰或權杖正確無誤
確保權杖尚未過期
更新認證資訊後，請再次測試動作。
安全性須知
Astra 內建了保護您資料和整合的安全措施。
認證受到保護
檢視動作詳情時，API 金鑰和密碼會被遮蔽（顯示為
*****）
伺服器端請求偽造 (SSRF) 防護
自動封鎖對內部或私有網路位址的請求
提供測試模式
使用測試模式即可驗證您的 REST API 動作，而不會影響即時資料或分析
遵循這些準則將有助於您快速解決問題，並確保您的 REST API 動作安全可靠。