代理擷取介面回傳HTTP 200,工作程序卻沒有可用端點。先別認定住宅資源池已空:回應可能是業務錯誤、成功清單可能真的沒有資料,也可能是本機解析器把有效項目全數捨棄。先確認結果在哪一階段消失。
本流程適用於已授權、且使用帳號支援擷取模式的整合,並非已執行擷取或消耗額度的測試報告。取得代理端點與成功經端點連線,是兩個不同的驗收階段。
一、先區分四種空結果
- 沒有可用回應:逾時、傳輸失敗,或文件未定義為有效空結果的內容缺少、不完整。應記為請求或回應問題,不是已確認資源池為空。
- 業務錯誤:依介面規格,回應明確表示失敗,不因HTTP狀態改變分類。
- 確認空結果:符合文件的成功回應中,預期清單或文字格式確實零筆。
- 本機輸出為空:取得的回應有端點,但經選取、解碼、解析、驗證或篩選後剩零筆。
HTTP 200表示HTTP層級成功,整合仍需依回應表示與介面業務規格解讀。不要把每個例外都轉成空清單,否則四類情況的關鍵證據會消失。
二、安全固定一筆失敗請求
記錄含時區時間、方法、端點路徑、選定產品或模式、請求數量、核准地區條件、輸出格式、用戶端版本、HTTP狀態、媒體類型及回應大小。格式提供業務狀態與安全錯誤訊息時,也依規格記錄。僅在允許且必要時保存受限回應樣本。
實際規格以98IP公共介面設定文件為準,文件列出appKey是必要公共參數。應將其放在核准的機密儲存中,不要為方便而把含密鑰的產生連結放入記錄、截圖、支援單或瀏覽器歷程。擷取密鑰不必然等於後續代理連線使用的驗證憑證。
再查看目前方法專屬文件,以及登入帳號可用的設定產生器。本文不捏造未確認的介面方法、結果欄位名稱、錯誤碼、庫存量或帳號限制。
三、計算端點之前,先驗證回應
- 確認請求到達預期API主機及路徑,記錄重新導向與最終媒體類型。用戶端成功跟隨導向取得登入HTML,並不代表取得端點清單。
- 選取資料前,先讀取文件定義的業務結果。驗證、權限、參數、餘額、額度及限速訊息,應依真實文件意義處理;未知回應不能直接判為庫存耗盡。
- 輸出格式必須與解析器一致。文字端點清單、JSON包裝及其他支援形式要採對應處理。缺少欄位、null、損壞格式與有效零筆清單,必須分開。
- 內容疑似截斷或無效時,保留安全證據並明確回報解析失敗。不要悄悄傳遞部分資料或自行補成成功。
配合98IP動態住宅代理產品頁確認產品及驗證模式。API、帳密與允許清單擷取入口是不同設定選擇,應核對當前帳號和文件真正支援的內容。產品頁不保證任何篩選條件隨時都有端點可取。
四、隔離參數,不越出工作授權
- 確認憑證及權限後,透過登入設定工具或文件方法產生基準請求,採用該方法允許的最小數量,產品與核准範圍不變。
- 逐欄比較失敗請求,分享證據時排除密鑰值。核對拼字、編碼、值類型、輸出格式及意外殘留的舊參數。
- 一次只改一個已支援條件。只有診斷授權與原工作允許時,才擴大地區或移除選填限制。另一國家的結果不符合原國家的工作要求。
- 各輪標為錯誤、確認空或有資料。找到設定差異或達到核准嘗試預算後停止。
核准的較寬查詢有資料、較窄查詢為空,支持繼續調查篩選條件,但不能證明永久缺貨,也不能逕自將較寬結果替換至正式工作。
五、為本機每一步轉換計數
對允許保存的回應或合成樣本,記錄四個數量:文件載荷中的項目數、解析得到數、端點格式驗證通過數,以及去重或業務篩選後保留數。每一步附安全的拒絕類別,並使用同一執行ID,避免比較到不同請求的記錄。
載荷五筆而解析零筆,先查格式或選取路徑;解析五筆但格式驗證全拒絕,核對文件實際定義的主機或位址及連接埠表示;自有篩選器移除五筆,則屬本機選取結果。這些數字僅為說明,不是服務商實測結果。
不要假定每個冒號都能切開主機與連接埠,尤其IPv6等受支援表示可能需要更謹慎處理。測試解析器時,不應反覆擷取新端點;可重播已核准遮罩樣本,或使用合成資料,避免暴露機密。
六、分開檢查擷取、有效期限及連線
取得項目後,選擇仍有效的端點,依要求協定與執行時驗證,對已授權目標做最小連線測試。記錄擷取時間及該資源規定的期限。端點過期,或之後出現類似HTTP代理407的驗證錯誤,不能證明先前擷取回應為空。不同協定錯誤形式不同,請以真正用戶端結果為準。
不要反覆擷取來修復目標網站的授權失敗,也不要忽略有效期限,拿舊清單端點製造擷取正常的假象。證據應分別說明哪個階段通過、哪個仍待處理。
七、停止無效的循環擷取
明確設定或驗證錯誤應先修正再呼叫;確認空回應時,依服務商重試文件與自己的次數、時間預算處理;未知結果要保留回應調查,不硬判成功或為空。測試前確認擷取呼叫是否消耗額度,或對帳號有其他影響。
支援材料應包含遮罩後的方法與參數、附時區時間、安全回應結果、請求與回傳數量,以及最小可重現授權案例。服務商提供請求識別碼時可記錄。不可附上appKey、代理密碼、簽章連結或不受限的端點匯出。
常見問題與檢查清單
空結果表示整個服務商資源池沒有IP嗎?不能。正確解讀回應後,也只能描述該請求在特定參數與帳號條件下的結果。
解析器遇到任何失敗都回空清單好嗎?不好。應保留錯誤、格式無效、空結果與有資料狀態,才能採取符合證據的下一步。
- 方法、產品、權限、參數及輸出格式符合目前文件。
- HTTP結果、業務結果及載荷結構分別記錄。
- 載荷、解析、驗證、保留計數能指出端點消失的階段。
- 受控參數變更維持核准工作範圍。
- 連線測試採用有效端點,判斷與擷取結果分開。
可在本機準備有效非空、文件定義的空結構、業務錯誤,以及損壞或錯誤格式樣本,確認每種情況進入不同診斷狀態。這是建議練習,並非已執行結果。僅使用已授權帳號與目標,遵守請求限制,依組織政策保留資料及密鑰。