Azure API 管理：WADL 文档不包含 'resources' 元素

Question

我正在尝试使用 Azure API 管理服务创建 API。为此，我有一个部署到 Azure Web 服务器和 returns XML 响应的服务，如下所示： XML Response

我正在尝试在 Azure API 管理服务实例上集成此端点，但收到如下所示的错误：Error on adding endpoint

我对此很陌生，需要有关问题原因以及我遗漏的其他内容的帮助。还有，我们在创建API

的时候可以给API字段一个什么样的终点

Answer 1

导入您的 API 时，您需要提供 URL，这可能 return 您的 API 的 规范 （不是你的 API 的 URL）。当您选择 WADL format 时，请提供一个 URL 可以 return 您的 API 规格如下。

<resources base="http://xx.domain.com/api/">
  <resource path="newsSearch">
    <method name="GET" id="search">
      <request>
        <param name="p1" style="query" type="xsd:int" default="1"/>
        <param name="p2" style="query" type="xsd:string" default="abc"/>
      </request>
      <response status="200">
        <representation mediaType="application/xml" element="yn:ResultSet"/>
      </response>
      <response status="400">
        <representation mediaType="application/xml" element="ya:Error"/>
      </response>
    </method>
  </resource>
</resources>

如果您的 API 是由 ASP.NET Web API 创建的，您可以使用 Swashbuckle 生成 swagger 格式规范。然后您可以通过选择 Swagger 格式导入您的 API 规范。