Включить формат в swagger, сгенерированный из веб-API С#

В спецификации OpenAPI нет такой вещи, как string($int32). Это должно быть либо string, если это действительно строка (независимо от того, отформатирована ли она как int), либо должно быть integer($int32), если это целое число.

Два других фиксируются следующим образом:

public class OrderItem
{
    public Guid TitleOrderId { get; set; }
    public DateTime OrderDate { get; set; }
    public int DocumentCount { get; set; } // or change to string if it should be a string
}

ОБНОВЛЯТЬ

Чтобы добавить описание, вам необходимо установить Swashbuckle.AspNetCore.Annotations NuGet Package.

Затем включите аннотации в Startup.cs:

services.AddSwaggerGen(c =>
{
   ...

   c.EnableAnnotations();
});

Затем вы добавляете описание, используя атрибут SwaggerSchema. Вы также можете установить DocumentCount на string и добавить параметр формата int32. Это нарушит спецификацию OpenAPI, но будет делать то, что вы хотите:

public class OrderItem
{
    [SwaggerSchema("id of the title order - not a file number")]
    public Guid TitleOrderId { get; set; }

    public DateTime OrderDate { get; set; }

    [SwaggerSchema(Format = "int32")]
    public string DocumentCount { get; set; }
}

Вы также можете сделать это так, если очень хотите, но я бы рекомендовал оставить типы Guid и DateTime:

public class OrderItem
{
    [SwaggerSchema("id of the title order - not a file number", Format = "uuid")]
    public string TitleOrderId { get; set; }

    [SwaggerSchema(Format = "date-time")]
    public string OrderDate { get; set; }

    [SwaggerSchema(Format = "int32")]
    public string DocumentCount { get; set; }
}