Skip to content

Commit 557c6db

Browse files
committed
DavidBiesack's changes
1 parent 34d1aec commit 557c6db

File tree

1 file changed

+3
-4
lines changed

1 file changed

+3
-4
lines changed

versions/3.0.md

Lines changed: 3 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -106,20 +106,19 @@ For example, if a field has an array value, the JSON array representation will b
106106
"field": [...]
107107
}
108108
```
109-
110-
While the API is described using JSON, input to and output from the API is not required to be JSON.
111-
112109
All field names in the specification are **case sensitive**.
113110

114111
The schema exposes two types of fields: Fixed fields, which have a declared name, and Patterned fields, which declare a regex pattern for the field name.
115112

116-
Multiple occurrences of patterned fields need to have unique names.
113+
Patterned fields MUST have unique names within the containing object.
117114

118115
In order to preserve the ability to round-trip between YAML and JSON formats, YAML version [1.2](http://www.yaml.org/spec/1.2/spec.html) is recommended along with some additional constraints:
119116

120117
- Tags MUST be limited to those allowed by the [JSON Schema ruleset](http://www.yaml.org/spec/1.2/spec.html#id2803231).
121118
- Keys used in YAML maps MUST be limited to a scalar string, as defined by the [YAML Failsafe schema ruleset](http://yaml.org/spec/1.2/spec.html#id2802346).
122119

120+
**Note:** While APIs are described with JSON or YAML Open API documents, the API request and response bodies and other content are not required to be JSON or YAML.
121+
123122
### <a name="fileStructure"></a>File Structure
124123

125124
The OAS representation of the API is made of a single file.

0 commit comments

Comments
 (0)