即時顯示驗證提醒,有效把關回覆內容!
除了一般文字、Email、電話、網址等驗證方式,SurveyCake 現在還支援 API 文字驗證的服務。您可以將自行開發的 API 串接在問卷中,讓回傳字串即時顯示在頁面上,同時依據 API 回傳的結果決定該題驗證是否通過,不僅能提升填答精確度、也讓填寫過程更加順暢友善。
文字驗證 API 可以應用在許多不同的情境中,例如:驗證報帳問卷中的統一發票編號,或是在公司舉辦活動、進行考核時,驗證填答問卷中的員工編號。
以「員工績效考核調查」為例:
若是輸入錯誤的員工編號格式,則會透過 API 驗證為不通過,並在作答框底下顯示未通過驗證的提示訊息(也就是下方左圖中的紅色文字)且將無法送出問卷;若輸入正確的員工編號格式,則會通過 API 驗證,並在作答框底下顯示通過驗證的提示訊息(也就是下方右圖中的灰色文字),並且可以成功送出問卷。

如此一來,問卷建立者就能統一填答者的回覆格式,確保資料的一致性;填答者在回答問題時,也能清楚了解填答是否符合題目要求。
而接著,以下將介紹該如何設定文字驗證 API 及背後的運作方式:
題型設定
在問卷後台建立單行文字題或多行文字題,並點擊工具列中的輸入設定開啟文字驗證並選擇 API、貼上您自行開發的 API 網址,按下「套用」即完成設定。

文字驗證 - API 運作方式
完成文字驗證 - API 的設定後,當填答者填寫該題目時,系統會以 POST 方式將問卷 ID 和題目的值帶給驗證 API。

驗證 API 可以針對輸入的值進行驗證,讓系統回傳對應的格式,並將回傳驗證的結果即時顯示在問卷頁面上,同時驗證該題是否通過。
以下圖為例:當 API 的 Status 回傳 200 時,該題會驗證通過,並將 API 回傳的 msg 字串顯示於問卷頁面上。


當填答通過驗證時,會在問卷中即時顯示 API 回傳的 msg 字串(即上圖的「早安 🙋♂️」)
而如果 API 的 Status 回傳非 200 時,該題則會驗證不通過,並將 API 回傳的 msg 字串顯示於問卷頁面上。


當填答驗證失敗時,也會在問卷中即時顯示 API 回傳的 msg 字串(即上圖的「無效的員工編號 🙅♂️」)
常見問題
Summary
善用文字驗證 - API 功能,不僅能統一回覆格式,還能透過即時回傳的字串,讓填答者在填寫問卷時變得更加友善!