Skip to content
ADP
API Design PrincipleBETA

[ADP-141] User-Agent

概述

User-Agent HTTP 標頭是由客戶端發送給伺服器以識別自身的字串。它通常包含有關客戶端應用程式、作業系統、軟體供應商或版本的資訊。

指導原則

  • 不得(MUST NOT)使用 User-Agent 進行客戶端識別,因為這會引起隱私問題。請參閱 ADP-354: Client Hints 以了解更能保護隱私的替代方案。

  • 應(SHOULD)將 User-Agent 視為不可靠的資訊,因為客戶端可以輕易偽造或修改它。

  • 可以(MAY)將 User-Agent 用於分析或除錯目的,但不得依賴它來實現關鍵功能。

範例

典型的 User-Agent 字串

http
User-Agent: Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/91.0.4472.124 Safari/537.36

API 客戶端的最小 User-Agent

http
User-Agent: MyAPIClient/1.0

相關 ADPs

參考資料