通过

你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

JSONP

  • 项目

适用于：所有 API 管理层级

jsonp 策略向操作或 API 添加填充型 JSON (JSONP) 支持，以便从基于 JavaScript 浏览器的客户端执行跨域调用。 JSONP 是 JavaScript 程序中使用的方法，用于从不同域中的服务器请求数据。 JSONP 规避了大多数 Web 浏览器强制实施的只能在同一域中访问网页的限制。

注意

按照策略声明中提供的顺序设置策略的元素和子元素。 详细了解如何设置或编辑 API 管理策略。

策略语句

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

属性

客户 说明 需要 默认
callback-parameter-name 以函数所在的完全限定域名为前缀的跨域 JavaScript 函数调用。 允许使用策略表达式。 是 空值

使用情况

使用注意事项

  • 此策略只能在策略部分中使用一次。

示例

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

如果调用此方法时没有回调参数 ?cb=XXX，该方法将返回无格式 JSON（不带函数调用包装器）。

如果添加回调参数 ?cb=XXX，它将返回 JSONP 结果，并使用原始 JSON 结果包装回调函数，例如 XYZ('<json result goes here>');

相关内容

有关使用策略的详细信息，请参阅：