mirror of
https://github.com/LukeHagar/redocly-cli.git
synced 2025-12-06 12:47:48 +00:00
2.3 KiB
2.3 KiB
slug
| slug |
|---|
| /docs/cli/rules/required-string-property-missing-min-length |
required-string-property-missing-min-length
Requires that every required property in the API description with type string has a minLength.
| OAS | Compatibility |
|---|---|
| 2.0 | ✅ |
| 3.0 | ✅ |
| 3.1 | ✅ |
API design principles
The minLength keyword constrains string values. When a property of type string is required, defining the minLength helps prevent common mistakes, such as empty strings. Use the minLength property as a best practice to ensure data integrity and enhances the overall quality of the API.
Configuration
To configure the rule, add it to the rules object in your configuration file.
Set the desired severity for the rule.
rules:
required-string-property-missing-min-length:
severity: error
| Option | Type | Description |
|---|---|---|
| severity | string | Possible values: off, warn, error. Default off (in recommended configuration). |
An example configuration:
rules:
required-string-property-missing-min-length: error
Examples
Given this configuration:
rules:
required-string-property-missing-min-length: error
Example of an incorrect schema:
schemas:
User:
type: object
required:
- name
properties:
name:
description: User name
type: string
Example of a correct schema:
schemas:
User:
type: object
required:
- name
properties:
name:
description: User name
type: string
minLength: 2