資料用戶端經代理收到406,瀏覽器卻能開同一地址;改成Accept: */*之後雖然200,JSON解析器卻收到HTML。這個流程尚未修復整合。先查要求的回應格式、端點契約和實際內容,再調整代理。本指南是獲授權測試程序,不是98IP或目標服務的相容性實測。

1. 定義任務能處理的回應
記錄端點、方法、授權範圍、預期媒體類型、解析器及最小結果。自有合成商品案例除了可解析,還須符合商品ID、市場與結構版本。登入頁成功不代表商品資料成功,瀏覽器的人類頁面也不能直接當另一個API路由的基準。
Accept表達能接受的回應媒體類型;請求Content-Type描述送出的本文。在無本文GET修改Content-Type,並非要求JSON。406可能來自回應協商失敗,415關注請求表示。語言與編碼也是協商維度,這次媒體類型調查保持它們不變;狀態碼本身不能證明哪層產生回應。
2. 查最終合併後的Accept
- 檢查共享預設、SDK設定及單次覆寫完成後的有效Accept,先移除證據中的秘密。
- 確認全域application/json是否錯套至網頁、圖片或匯出端點;瀏覽器資源維持各自請求情境。
- 排查重複欄位或意外清單合併,指定負責的設定層,使用一個有意定義的值。
- 依端點文件核對支援類型。供應商專用JSON媒體類型即使包含JSON,也不自動等同application/json這項協商選擇。
- 記下轉址及最終目的地;登入或錯誤路由不能證明原API已成功協商。
設定畫面與接收端所見可能不同。自有預備環境記錄收到的Accept及關聯識別,不記憑證。請求未出現時,先取得擁有者的入口證據,再討論代理歸因。
3. 執行四種表示案例
使用唯讀夾具,每例固定URL、Cookie、地區、方法及工作階段策略。依序要求文件支援類型、另一個確實支援的類型、語法有效但夾具刻意不提供的類型,以及*/*診斷控制組。不經授權不得在第三方端點製造負例。
每例保存實際Accept、狀態、回應Content-Type、最終路由、解析結果及預期資料身分。設小型請求預算,在核准基準與代理路徑跑相同案例。無法直連就註記缺少該基準,不宣稱代理必定造成差異。
支援例應符合文件契約;不支援例由擁有者訂明406或預設表示,不要求每個伺服器必須406。通配符得到200只代表有某種回應,消費端必須被明確設計及驗證能處理它,才算可用的正式行為。
4. 依觀察選擇處理方向
- 兩路都拒絕相同窄Accept:確認端點及可用格式,換出口不能新增格式。
- 用戶端值正確,自有接收端卻觀察到別值:以關聯證據查共享中介層、轉址重建或明確配置的攔截。
- 代理路徑最後到不同路由:先查授權或地區導向,不讓解析器硬收網頁。
- 兩路200但類型或資料身分不同:比較失敗,查明變體,不只看狀態。
一般未攔截的HTTPS CONNECT隧道中,正向代理無法讀取或改寫加密內層Accept。錯誤頁及Server標頭只能作線索。若安全邊緣用406表達其他政策,向擁有者查具體規則及請求證據;不以偽裝流量規避規則。
5. 修復消費契約並驗證重用
按端點設定實際可處理的Accept,只用文件支援的版本路由或供應商類型。若需要回退,為每個允許類型配置獨立解析及語義檢查;不能將HTML當作空JSON成功。
一起驗證回應Content-Type及解碼內容。標頭正確不保證語法或結構正確。錯誤內容可能有意使用不同於成功表示的類型,按實際狀態與文件錯誤格式處理,不交給成功解析器。
自有多表示端點沿正常快取路徑依序測結構化資料、文件、再結構化資料。逐次查類型及資料身分,請擁有者檢查快取鍵,以及協商選擇變體時的Vary。一次孤立成功不代表共用快取保持表示邊界;不得清除或修改第三方快取。
6. 98IP適用的比較環節
需要從指定客戶地區比較獲授權API行為時,查閱98IP動態住宅IP產品頁,依98IP設定文件及帳戶設定取得支援參數。矩陣內固定地區及工作階段策略,核對實際出口。
地區代理可協助辨識路由或表示差異,不能創造API未支援的格式,也不保證各區回應相同。本文未實測吞吐、用戶端相容性或失敗請求計費。限制次數、核對用量,只處理獲授權的合成或批准資料。
7. 驗收清單與常見問題
- 端點、成功媒體類型及端點專屬有效標頭皆有紀錄。
- 支援、備選、不支援、通配案例各有預期及實際結果。
- 狀態、最終路由、Content-Type、解析與資料身分一起通過。
- 錯誤保持錯誤,HTML不默默變成空JSON,快取重用保留選定變體。
- 支援證據包含關聯識別及去識別化標頭,不含權杖、Cookie、代理密碼或客戶內容。
*/*是萬用修復嗎? 不是。擴大協商可能選到解析器不能使用的回應;所有允許結果都有處理路徑前,僅用於受控診斷。
application/*代表所有JSON供應商類型能互換嗎? 不代表。寬範圍只影響協商,不保證結構、版本或解析支援,仍須查實際類型與內容。
可移除所有標頭測試嗎? 在獲授權夾具上一次只改相關維度。一起刪授權、語系及其他狀態,會破壞比較甚至改到別的資源。