核准的匯出請求透過代理回傳HTTP 202,表示連線可用且伺服器接受請求,卻不代表報告已完成。提交接受、狀態觀察、工作終態與結果內容可用,應為四個獨立驗收點。
本文為自有或授權非同步API提出有預算的測試方案。範例狀態僅供說明,不是98IP介面欄位或服務實測。請在預備環境使用無害合成匯出,不建立正式訂單或重複真實匯出。
一、先確認目的API契約
確認提交方法、接受回應、工作參照、監控位址、驗證範圍、狀態詞彙、結果取得方式與保留期間。HTTP 202表示接受處理,不保證完成。不要假設每個202都有Location、工作ID或相同JSON結構。
依實際文件定義終態成功、終態失敗與仍在處理。狀態端點的HTTP成功可能帶有業務失敗;暫時讀不到狀態,也不證明底層工作失敗。
二、僅建立一個合成工作並保留參照
- 選擇小型已知輸入及預期結果,案例ID不含個人資訊。
- 在核准預算內提交一次,記錄回應、時間、應用程式身分及遮蔽的資源參照。
- 輪詢前將回傳參照與文件化監控位置寫入紀錄。具有存取能力的位址只放核准機密儲存,不放共用紀錄。
- 依核准目的政策驗證監控位址協定、主機及路徑,相對位址依文件指定基準解析。
狀態網址不是對任意重新導向目的傳送憑證的許可。遵循目的服務驗證規則,不自動向不同來源轉送Bearer權杖。監控參照缺漏或無效應調查契約,不猜測端點。
三、分開代理設定與工作身分
98IP動態住宅IP產品頁可協助確認授權地區API測試所用路徑產品,並須查核目前帳號實際地區及工作階段選項。API設定文件說明已公布的代理連線,不證明目的服務有特定非同步匯出介面或工作結構。
觀察期間沿用相同應用程式身分與工作參照,路徑別名另列。不能假設更換出口就建立新工作、恢復驗證,或一定符合目的服務的工作階段規則。服務要求連續性時應遵守,受控路徑變更案例須明確標記。
四、為狀態查詢設定預算
執行前約定總觀察期限、最大狀態呼叫數、單次逾時,以及文件規定或核准的輪詢節奏。依契約處理有效的伺服器重試指引。等待若會超過剩餘觀察窗口,就停止觀察,不為符合預算而提前輪詢。
本測試每項工作只保留一個活動輪詢器。狀態讀取暫時失敗時,在預算內重試讀取,沿用原參照,不重送提交。驗證失敗須檢查授權憑證或工作階段,不代表可以密集查詢或換IP規避限制。
用戶端觀察逾時與工作終態必須區分。達到期限或呼叫上限時,記錄未確定、最後確認狀態與後續負責人。停止輪詢不證明工作停止,也不能取代文件化取消動作。
五、獨立驗收終態及結果
文件定義的終態成功出現後,依核准目的路徑及驗證流程取得結果。查核型別、樣本身分、預期紀錄鍵及完整性;已知小樣本亦可比較預期內容雜湊。HTTP 200背後若是登入頁或不完整報告,不算匯出驗收通過。
紀錄保留四欄:提交接受、最後工作狀態、結果取得情況、結果內容判定。下載失敗時保留已知成功終態,另查取得路徑,不因輸出下載逾時就建立替代工作。
例如合成工作先接受,之後回報成功,但結果少了一個預期樣本鍵,正確判定為「工作成功,結果驗收失敗」,不是代理成功,也不應增加完成匯出數。
六、測試恢復時避免重複工作
於自有預備API或文件化測試介接器演練:延遲終態、一次暫時狀態讀取錯誤、終態業務失敗,以及成功狀態卻缺少結果內容。確認各自產生不同判定。這些是建議演練,並非已執行測量。
也應在接受參照存妥後重啟測試用戶端,繼續觀察同一合成工作,確認第二程序不會建立額外輪詢器。伺服器若表示參照未知或過期,依文件保留及恢復流程處理,不據此認定從未執行;不確定性尚未經授權決策處理前,不重建工作。
比較路徑時,基準與代理各用等價獨立合成工作,固定樣本及觀察政策。分別比較接受情況、觀察到的工作時間與結果判定。單次緩慢觀察無法區分代理瓶頸、目的服務排隊或輪詢間隔。
常見問題與完成清單
每個HTTP 202都能算完成嗎?不能,必須依目的服務確認的終態及工作流程要求的結果檢查。
所有介面都處理中202、完成200嗎?不是,請依目的文件的狀態及載荷規則,不套用通用對應。
- 工作結構、監控目的與驗證範圍有文件。
- 接受參照可跨用戶端重啟保留,不重複提交。
- 輪詢有期限、呼叫上限與核准等待政策。
- 讀取失敗及觀察逾時不杜撰工作終態。
- 終態成功、下載及內容完整性分別判定。
- 未確定工作有負責人及授權恢復決策。
只用核准API與合成資料,限制請求及產物保留,遮蔽權杖、簽章監控連結及代理機密。不要從本建議方案宣稱實測吞吐、流量節省、註冊、訂單或工作完成率。