Service Endpoint 的核心概念是「外部請求進入服務的明確位置」。它是網路流量進入應用程式邊界的地址、路徑或命名位置。 可先對照 Request Routing。

概念位置

Service Endpoint 位在 client、load balancer、WAF 與 application 之間，是服務對外暴露能力的入口界面，常與 Request Routing 一起決定流量如何進入。

可觀察訊號

系統需要 service endpoint 分級的訊號是不同入口承擔的風險不同。公開 API、管理入口、診斷入口與內部入口的流量來源、權限要求與失敗後果都不一樣。

接近真實網路服務的例子

公開 API 需要穩定的 request/response 合約；Public API Endpoint 需要更高的相容性與文件品質；Admin Endpoint 需要更高權限與來源限制；Diagnostic Endpoint 需要避免暴露過多內部資訊；Internal Endpoint 需要搭配 service discovery 與內部網路邊界。

設計責任

設計時要先定義 service endpoint 的用途、可達範圍、授權層級與錯誤回應策略。更細的入口語意應拆成專門卡片，而不是把所有 HTTP 路徑都當成同一種入口。