获取方法未在Azure Api Management开发人员门户中显示<example>文档

问题描述

我有一个带有Swashbuckle 5.5.1的API,并且GET方法在Azure Api Managment开发人员门户上无法正确显示文档,但是在swagger门户上可以正确显示文档。 例如,此代码显示Swagger门户上的文档:

    /// <summary>
    /// The total amount of the invoices.
    /// </summary>
    /// <example>10.59</example>
    public decimal? Amount { get; set; }

    /// <summary>
    /// The status of the invoices.
    /// </summary>
    /// <example>1</example>
    public AffiliateInvoiceStatusModel Status { get; set; }

    /// <summary>
    /// The invoice type of the invoices.
    /// </summary>
    /// <example>2</example>
    public InvoiceTypeModel InvoiceType { get; set; }

在Swagger中捕获文档

Azure Api Management开发人员门户上的文档捕获

有什么方法可以显示GET方法的文档?在开发人员门户网站上必须进行某种类型的配置,似乎忽略了swagger.json中的某些值。

POST,PUT或DELETE方法文档正确显示

解决方法

目前尚不支持此功能,但是我们正在努力改善对APIM OpenAPI的支持。