Share via


JSONP

適用於:所有 API 管理 層

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

注意

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

原則陳述式

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

屬性

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

使用方式

使用注意事項

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

範例

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

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

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

如需使用原則的詳細資訊,請參閱: