Azure函数Swagger文档查看地址及外部链接相关技术咨询

1. 如何通过外部链接查看Azure函数的Swagger文档？ #

要通过外部链接访问Azure函数的Swagger文档，得先做好基础配置，再分两种场景操作：

• 如果你用Swashbuckle这类扩展为函数生成了Swagger文档并启用了可视化UI：
  直接访问函数应用域名下的 http://<你的函数应用域名>/api/swagger/ui 路径，就能在外部浏览器打开可视化的Swagger界面。不过前提是要在函数项目里安装对应的扩展包，并且在代码里配置好Swagger的生成规则。
• 如果你是在Azure门户的API定义模块中配置的Swagger文档（比如上传本地的Swagger JSON/YAML，或者链接到存储账户里的文档）：
  配置完成后，Azure会自动生成可公开访问的链接，你只要在API定义的配置页面找到这个链接，复制后直接在外部浏览器打开就行——既能查看原始的Swagger结构文件，也能通过对应的UI路径查看可视化界面。

2. 针对地址为http://foo.azurewebsites.net/api/v1/bar的Azure函数，门户API定义中Swagger文档的查看URL是什么？ #

当你在Azure门户的API定义里完成配置后，可视化的Swagger UI访问URL通常是：
http://foo.azurewebsites.net/api/swagger/ui

另外补充两个细节：

• 如果想直接查看原始的Swagger JSON文件，对应的路径一般是 http://foo.azurewebsites.net/api/swagger/json（如果是YAML格式就是/api/swagger/yaml）
• 要确保函数应用没有配置严格的IP限制或身份验证拦截这类规则，否则可能需要先通过权限验证才能访问这些端点。

内容的提问来源于stack exchange，提问作者Eric Jorgensen