JSONP

適用於：所有 APIM 層

jsonp 原則會將 JSON 與補充的 (JSONP) 支援加入至作業或 API，以允許來自 JavaScript 瀏覽器型用戶端的跨網域呼叫。 JSONP 是 JavaScript 程式中使用的方法，可從位於不同網域的伺服器要求資料。 JSONP 會略過大多數網頁瀏覽器中規定必須在相同網域內才能存取網頁的限制。

注意

請依照原則陳述式中提供的順序，來設定原則的元素和子元素。 深入了解如何設定或編輯 APIM 原則。

原則陳述式

<jsonp callback-parameter-name="callback function name" />

屬性

名字	描述	是必要欄位	預設
callback-parameter-name	跨網域 JavaScript 函數呼叫，開頭加上函數所在的完整網域名稱。 允許使用原則運算式。	Yes	N/A

使用方式

• 原則區段：輸出
• 原則範圍︰全域、工作區、產品、API、作業
• 閘道： 傳統、v2、使用量、自我裝載、工作區

使用注意事項

• 此原則只能在原則區段中使用一次。

範例

<jsonp callback-parameter-name="cb" />

如果呼叫方法時未指定回呼參數 ?cb=XXX，則會傳回一般 JSON (沒有函式呼叫包裝函式)。

如果加上回呼參數 ?cb=XXX，則會傳回 JSONP 結果，在回呼函式旁邊包裝原始的 JSON 結果，例如 XYZ('<json result goes here>');

相關原則

• Cross-domain

相關內容

如需使用原則的詳細資訊，請參閱：

• 教學課程：轉換及保護 API
• 原則參考，取得原則陳述式及其設定的完整清單
• 原則運算式
• 設定或編輯原則
• 重複使用原則設定
• 原則程式碼片段存放庫 (英文)
• 使用 Microsoft Azure Copilot 撰寫原則