@ApiModelProperty 注解：在 Swagger 文档中描述 API 属性

@ApiModelProperty 是一个注解，用于在 Swagger 文档中描述 API 的属性。它可以用于类的字段或方法的参数上。它的作用是：

1. 描述 API 的属性：@ApiModelProperty 可以通过设置属性的名称、数据类型、描述、是否必需等来描述 API 的属性。

2. 自动生成 API 文档：Swagger 可以根据 @ApiModelProperty 的配置来自动生成 API 文档，包括属性的名称、描述、数据类型等信息。

3. 提供更详细的属性信息：@ApiModelProperty 可以提供更详细的属性信息，例如属性的最小值、最大值、默认值等，以便开发人员更好地理解和使用 API。

4. 支持数据校验：@ApiModelProperty 可以与其他数据校验注解（如 @NotNull、@Min、@Max 等）一起使用，用于对属性进行数据校验。

总之，@ApiModelProperty 提供了一种在 Swagger 文档中描述和定义 API 属性的方式，使得 API 文档更加清晰、准确，并且可以与其他数据校验注解一起使用，提高 API 的可用性和安全性。