如何正确设置 Swagger for PowerApps？

Question

这是我想要连接到我的 PowerApps 的 Azure 函数

        [FunctionName("ConvertMe")]
    public static IActionResult RunAsync
        ([HttpTrigger(AuthorizationLevel.Function, "get", Route = null)] HttpRequest req, ILogger log)
    {
        log.LogInformation($"Received a Request");
        ConvertMe Converter = new ConvertMe();

        string test1 = req.Query["image1"];
        string test2 = req.Query["image2"];


        MagickImage _Main = new MagickImage(Convert.FromBase64String(test1), MagickFormat.Png);
        MagickImage _Overlay = new MagickImage(Convert.FromBase64String(test2), MagickFormat.Png);

        using (MemoryStream memory = new MemoryStream())
        {
            Converter.ComebineBitmap(_Main, _Overlay).Write(memory, MagickFormat.Png);
            memory.Position = 0;
            return new FileContentResult(memory.ToArray(),"image/png");
        }

    }

它已经在本地运行，但我想在 PowerApps 中使用它。 如何获得 Swagger 的返回值？

我目前的招摇文件

    {
  "swagger": "2.0",
  "info": {
    "version": "1.0.0",
    "title": "MyAzureFunction"
  },
  "host": "xxx",
  "paths": {
    "/api/ConvertMe": {
      "get": {
        "description": "Calls my azure function over https",
        "operationId": "ConvertMe",
        "parameters": [
          {
            "name": "code",
            "in": "query",
            "description": "code",
            "default": "code",
            "type": "string"
          },
          {
            "name": "image1",
            "in": "query",
            "required": true,
            "type": "string"
          },     
          {
            "name": "image2",
            "in": "query",
            "required": true,
            "type": "string"
          },

        ],
        "responses": {
          "200": {
            "description": "Successful response",
            "schema": {
              "title": "The response of the api.",
              "type": "string"
            }
          }
        }
      }
    }
  }
}

我从未使用过 swagger，但我已经发现，最好是使用 base64 字符串。

Answer 1

微软有一个creating an OpenAPI definition from a server-less API 的教程。如果您按照列出的步骤进行操作，您最终将进入下载OpenAPI 定义步骤，您可以使用该步骤将其用于import into powerapps to make your custom connector.