適用対象: すべての API Management レベル
jsonpポリシーは、JSON with padding (JSONP) のサポートを操作または API に追加して、JavaScript ブラウザーベースのクライアントからのクロス ドメイン呼び出しを可能にします。 JSONP は、異なるドメインのサーバーのデータを要求するために JavaScript プログラムで使用される方法です。 JSONP を使用すると、Web ページへのアクセスが同じドメイン内である必要があるという、ほとんどの Web ブラウザーで適用される制限を回避できます。
注
ポリシーの要素と子要素を、ポリシー ステートメントで指定された順序で設定します。 API Management ポリシーを設定または編集する方法について説明します。
ポリシー ステートメント
<jsonp callback-parameter-name="callback function name" />
属性
| 名前 | 説明 | 必要 | 既定値 |
|---|---|---|---|
| callback-parameter-name | 関数が含まれる完全修飾ドメイン名をプレフィックスとするクロスドメイン JavaScript 関数呼び出し。 ポリシー式を使用できます。 | はい | 該当なし |
使用法
- ポリシー セクション: outbound
- ポリシー スコープ: グローバル、ワークスペース、製品、API、操作
- ゲートウェイ: クラシック、v2、従量課金、セルフホステッド、ワークスペース
使用上の注意
- このポリシーは、ポリシー セクションで 1 回だけ使用できます。
例
<jsonp callback-parameter-name="cb" />
コールバック パラメーター ?cb=XXX なしでメソッドを呼び出した場合、(関数呼び出しラッパーのない) プレーン JSON が返されます。
コールバック パラメーター ?cb=XXX を追加した場合、元の JSON 結果をコールバック関数でラップして JSONP 結果が返されます (例: XYZ('<json result goes here>');)
関連ポリシー
関連するコンテンツ
ポリシーに対する処理の詳細については、次のトピックを参照してください。