Sandbox
用於身分驗證的 sandbox API 金鑰。
sandbox 金鑰會以與正式環境完全相同的 API、託管頁面及 webhook 流程運作，而且該金鑰永遠不會計費。這是在洽談價格之前，最快了解 ShieldID 是否適合您的方式。
運作方式
相同的流程。不同的金鑰。沒有帳單。
Sandbox 不是簡化的展示模式，而是真正的驗證流程，唯一的差別在於您傳送的是哪一把金鑰。
| 金鑰前綴 | vk_sand_… 會在您驗證身分的當下識別出這是 sandbox 金鑰。您無需另外設定 sandbox 帳號或儀表板。 |
|---|---|
| 環境標記 | 使用 sandbox 金鑰建立的每個工作階段、結果與 webhook 都會帶有 environment: "sandbox"，因此下游不會將任何 sandbox 建立的內容誤認為真實驗證。 |
| 計費 | 在所有方案中，sandbox 工作階段一律不計費，您可依建置與測試整合所需的數量隨意使用。 |
| 驗證本身 | 真實：使用您自己的證件、您自己的臉，以及相同的檢查。沒有另外提供一組假的測試證件，您需要驗證自己的身分，才能了解產品的實際表現。 |
取得金鑰
今天就申請一把。自助服務即將推出。
符合條件之方案的自助式 sandbox 金鑰建立功能已在規劃中，但尚未排定時程。在推出之前，您可透過聯絡表單提出申請，直接取得金鑰。
即將推出
即將推出符合條件之方案的自助式 sandbox 金鑰建立功能已在規劃中，但尚未排定時程，讓您註冊後立即就能產生金鑰。
親自試試看
您可以在自己手機上執行的測試情境。
不需要假證件，直接用您自己的身分證件來測試，看看每條路徑的實際表現。
順利通過
建立工作階段，開啟託管頁面，拍攝您自己的證件並完成活體偵測挑戰。觀察 checks.document、checks.liveness、checks.antispoof 與 checks.face_match 是否都回傳 PASS。
拒絕相機權限
在託管頁面詢問時拒絕相機權限。工作階段會以 FAILED 結束，並附帶 failure_reason，您可以據此設計真實的錯誤訊息。
失敗後重試（即將推出）
重新開啟 FAILED 工作階段的 verification_url，將其重設為 PENDING 以進行第二次嘗試，這項功能尚未上線。目前請將 FAILED 視為最終狀態，若申請人想再試一次，請建立新的工作階段。
已過期的工作階段
建立工作階段後不要動它。經過預設時間後，它會變成 EXPIRED，且沒有任何人員或檢查資料，非常適合用來測試您介面的逾時提示訊息。
已取消的工作階段
對處於 PENDING 狀態的工作階段呼叫 DELETE /v1/sessions/{id}，然後嘗試開啟 verification_url。確認您的應用程式將已取消的工作階段視為已結束，而不是錯誤。
法語語系
使用 locale: "fr" 建立工作階段，並確認託管頁面以及您自己的 return-URL 處理，對於說法語的申請人而言顯示正確。
限制
sandbox 無法做到的事。
直白的答案，沒有小字條款。
- Sandbox 與正式環境沒有各自獨立的速率限制，目前任何請求都不會受到方案層級的限制而被節流，該機制尚未上線。
- Sandbox 與正式環境僅以金鑰前綴區分，而非透過不同的帳號、儀表板或證件組別。
- sandbox 工作階段是對真實證件的真實驗證。請勿使用他人的證件來測試，請驗證您自己的證件。
常見問題