Sandbox
供身份驗證用嘅 sandbox API 金鑰。
sandbox 金鑰運行同正式環境一模一樣嘅 API、託管頁面同 webhook 流程，而且永不收費。喺傾價錢之前，呢個係睇 ShieldID 啱唔啱你嘅最快方法。
運作方式
同一條流程。唔同嘅金鑰。冇賬單。
Sandbox 唔係簡化版示範模式——佢係真正嘅驗證流程，純粹由你傳送嘅金鑰決定。
| 金鑰前綴 | vk_sand_… 會喺你認證嗰刻識別出 sandbox 金鑰。毋須另外設定 sandbox 帳戶或儀表板。 |
|---|---|
| 環境標記 | 用 sandbox 金鑰建立嘅每個 session、結果同 webhook 都帶有 environment: "sandbox"，所以下游唔會將任何 sandbox 建立嘅內容誤當成真正嘅驗證。 |
| 收費 | 所有方案下，sandbox session 都永不收費，你可以為建立同測試整合而運行任意數量嘅 session。 |
| 驗證本身 | 真實：你自己嘅證件、你自己嘅樣貌、同樣嘅檢查。冇另外一套假嘅測試證件——你要驗證自己，先會睇到產品嘅實際表現。 |
取得金鑰
今日就可以申請。自助申請即將推出。
合資格方案嘅自助 sandbox 金鑰建立功能已列入計劃，但未有時間表。喺推出之前，透過聯絡表格申請就可以直接取得金鑰。
即將推出
即將推出合資格方案嘅自助 sandbox 金鑰建立功能已列入計劃，但未有時間表,所以你一註冊就可以產生金鑰。
自己試下
你可以用自己部手機跑嘅測試情境。
唔需要假證件——用你自己嘅身份證件跑以下情境，睇下每條路徑實際點運作。
順利通過
建立 session，開啟託管頁面，拍攝你自己嘅證件並完成活體檢測挑戰。留意 checks.document、checks.liveness、checks.antispoof 同 checks.face_match 全部返回 PASS。
拒絕使用相機
當託管頁面要求相機權限時選擇拒絕。Session 會以 FAILED 結束，並帶有 failure_reason，你可以據此設計真正有用嘅錯誤訊息。
失敗後重試（即將推出）
重新開啟 FAILED session 嘅 verification_url，將佢重設為 PENDING 以作第二次嘗試，呢個功能暫時未推出。目前請將 FAILED 視為最終狀態——如果申請人想再試，就建立新 session。
已過期嘅 session
建立 session 後唔好理佢。過咗預設時限後，佢會變成 EXPIRED，冇人物或檢查資料——好適合用嚟測試你嘅 UI 逾時訊息。
已取消嘅會話
對處於 PENDING 狀態嘅會話呼叫 DELETE /v1/sessions/{id},然後嘗試開啟 verification_url。確認你嘅應用程式將已取消嘅會話視為已完成,而非錯誤。
法語語言設定
用 locale: "fr" 建立 session，確認託管頁面同你自己處理 return-URL 嘅方式，對講法語嘅申請人顯示正確。
限制
Sandbox 做唔到嘅嘢。
直接講清楚，冇細字。
- Sandbox 同正式環境冇各自獨立嘅速率限制——目前冇任何請求會受方案層級嘅限制節流；呢項限制機制尚未啟用。
- Sandbox 同正式環境純粹靠金鑰前綴區分，而唔係靠獨立帳戶、儀表板或證件組合。
- Sandbox session 係對真實證件嘅真實驗證。唔好用其他人嘅證件嚟測試——請驗證你自己嘅。
問題