文字驗證 - API

即時顯示驗證提醒,有效把關回覆內容!

除了一般文字、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 字串(即上圖的「無效的員工編號 🙅‍♂️」)

常見問題

  • 請問有相關的 API 程式碼範例可以參考嗎?
  • 由於文字驗證所使用的 API 程式碼會是由使用者自行開發,因此程式碼的寫法與邏輯會根據不同使用者的需求而定,SurveyCake 並未提供固定的範例程式碼喔!
  • 如果個人或公司內部無法自行開發 API,可以請 SurveyCake 協助嗎?
  • 可以的,目前 SurveyCake 企業版支援客製化開發與串接,若您有開發 API 的需求,歡迎填寫此份表單,後續將會有專人與您聯繫!

Summary

善用文字驗證 - API 功能,不僅能統一回覆格式,還能透過即時回傳的字串,讓填答者在填寫問卷時變得更加友善!

立即掌握 進階的問卷技巧!

了解更多
找不到你要的答案?