You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: versions/3.0.md
+6-6Lines changed: 6 additions & 6 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -1343,9 +1343,9 @@ application/json:
1343
1343
$ref: "#/components/examples/frog-example"
1344
1344
```
1345
1345
1346
-
##### Considerations for file uploads
1346
+
##### Considerations for File Uploads
1347
1347
1348
-
In contrast with the 2.0 specification, describing `file` input/output content in OpenAPI is
1348
+
In contrast with the 2.0 specification, `file` input/output content in OpenAPI is
1349
1349
described with the same semantics as any other schema type. Specifically:
1350
1350
1351
1351
```yaml
@@ -1360,9 +1360,9 @@ schema:
1360
1360
format: binary
1361
1361
```
1362
1362
1363
-
Note that the above examples apply to either input payloads (i.e. file uploads) or response payloads.
1363
+
These examples apply to either input payloads of file uploads or response payloads.
1364
1364
1365
-
A `requestBody` example for submitting a file in a `POST` operation therefore may look like the following:
1365
+
A `requestBody` for submitting a file in a `POST` operation may look like the following example:
1366
1366
1367
1367
```yaml
1368
1368
requestBody:
@@ -1388,7 +1388,7 @@ requestBody:
1388
1388
format: binary
1389
1389
```
1390
1390
1391
-
##### Support for x-www-form-urlencoded request bodies
1391
+
##### Support for x-www-form-urlencoded Request Bodies
1392
1392
1393
1393
To submit content using form url encoding via [RFC1866](https://tools.ietf.org/html/rfc1866), the following
1394
1394
definition may be used:
@@ -1409,7 +1409,7 @@ requestBody:
1409
1409
properties: {}
1410
1410
```
1411
1411
1412
-
Note that in the above example, the contents in the `requestBody` MUST be stringified per [RFC1866](https://tools.ietf.org/html/rfc1866/) when being passed to the server. In addition, the `address` field complex object will be stringified as well.
1412
+
In this example, the contents in the `requestBody` MUST be stringified per [RFC1866](https://tools.ietf.org/html/rfc1866/) when passed to the server. In addition, the `address` field complex object will be stringified.
1413
1413
1414
1414
When passing complex objects in the `x-www-form-urlencoded` content type, the default serialization strategy of such properties is described in the `parameterContent` section as `form`.
0 commit comments