JSONP
適用対象: すべての API Management レベル
jsonpポリシーは、JSON with padding (JSONP) のサポートを操作または API に追加して、JavaScript ブラウザーベースのクライアントからのクロス ドメイン呼び出しを可能にします。 JSONP は、異なるドメインのサーバーのデータを要求するために JavaScript プログラムで使用される方法です。 JSONP を使用すると、Web ページへのアクセスが同じドメイン内である必要があるという、ほとんどの Web ブラウザーで適用される制限を回避できます。
Note
ポリシーの要素と子要素を、ポリシー ステートメントで指定された順序で設定します。 API Management ポリシーを設定または編集する方法について説明します。
ポリシー ステートメント
<jsonp callback-parameter-name="callback function name" />
属性
| Name | 説明 | 必要 | Default |
|---|---|---|---|
| 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>');)
関連ポリシー
関連するコンテンツ
ポリシーに対する処理の詳細については、次のトピックを参照してください。
- チュートリアル:API を変換および保護する
- ポリシー ステートメントとその設定の一覧に関するポリシー リファレンス
- ポリシー式
- ポリシーの設定または編集
- ポリシー構成を再利用する
- ポリシー スニペットのリポジトリ
- Microsoft Copilot for Azure を使用してポリシーを作成する