API 網址模板
URI Template:展開、編碼與目的地界線
模板是資料轉文字的契約。先依要建立的 URI 元件選擇運算子,再於實際應用中審查產生的目的地。
內容更新: · 維護者與修正回報
運算子決定分隔符與跳脫
簡單展開、保留字元展開、路徑片段及查詢展開是不同操作。a/b 這類值可能依運算子被編成單一值,也可能保留分隔符。不能用 encodeURIComponent 取代整個演算法,也不能直接拼接未跳脫的查詢字串。
Level 4 加入適用值形狀的前綴與 explode 修飾符。未定義變數、空字串與空清單不可互換;請閱讀工具明示的輸入契約與運算式診斷。這裡的 JSON 物件提供變數,不是可執行程式。
展開文字,不是可信任端點
測試器只複製產生文字,不開啟或請求它。可展開的模板仍可能建立非預期 scheme、host、path 或 query;應用程式須另外限制目的地、驗證權限並使用正確 HTTP 方法。
示範網址不要放憑證或個資。即使在本機展開,複製或分享結果也會暴露其元件;輸入不會加入本工具網址、保存到瀏覽器儲存或當作分析值送出。
/items{/id}{?fields*}
{"id":"a/b","fields":["name","price"]}資料可信度