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
@@ -1386,30 +1386,29 @@ This object MAY be extended with [Specification Extensions](#specificationExtens
1386
1386
{
1387
1387
"application/json": {
1388
1388
"schema": {
1389
-
"$ref": "#/components/schemas/Pet"
1389
+
"$ref": "#/components/schemas/Pet"
1390
1390
},
1391
1391
"examples": {
1392
1392
"cat" : {
1393
1393
"summary": "An example of a cat",
1394
-
"value":
1395
-
{
1396
-
"name": "Fluffy",
1397
-
"petType": "Cat",
1398
-
"color": "White",
1399
-
"gender": "male",
1400
-
"breed": "Persian"
1401
-
}
1394
+
"value": {
1395
+
"name": "Fluffy",
1396
+
"petType": "Cat",
1397
+
"color": "White",
1398
+
"gender": "male",
1399
+
"breed": "Persian"
1400
+
}
1402
1401
},
1403
1402
"dog": {
1404
1403
"summary": "An example of a dog with a cat's name",
1405
-
"value" : {
1404
+
"value" : {
1406
1405
"name": "Puma",
1407
1406
"petType": "Dog",
1408
1407
"color": "Black",
1409
1408
"gender": "Female",
1410
1409
"breed": "Mixed"
1411
1410
},
1412
-
"frog": {
1411
+
"frog": {
1413
1412
"$ref": "#/components/examples/frog-example"
1414
1413
}
1415
1414
}
@@ -1419,7 +1418,7 @@ This object MAY be extended with [Specification Extensions](#specificationExtens
1419
1418
```
1420
1419
1421
1420
```yaml
1422
-
application/json:
1421
+
application/json:
1423
1422
schema:
1424
1423
$ref: "#/components/schemas/Pet"
1425
1424
examples:
@@ -1458,24 +1457,24 @@ Content transferred in binary (octet-stream) MAY omit `schema`:
1458
1457
```yaml
1459
1458
# a PNG image as a binary file:
1460
1459
content:
1461
-
image/png: {}
1460
+
image/png: {}
1462
1461
```
1463
1462
1464
1463
```yaml
1465
1464
# an arbitrary binary file:
1466
1465
content:
1467
-
application/octet-stream: {}
1466
+
application/octet-stream: {}
1468
1467
```
1469
1468
1470
1469
Binary content transferred with base64 encoding:
1471
1470
1472
1471
```yaml
1473
1472
content:
1474
-
image/png:
1475
-
schema:
1476
-
type: string
1477
-
contentMediaType: image/png
1478
-
contentEncoding: base64
1473
+
image/png:
1474
+
schema:
1475
+
type: string
1476
+
contentMediaType: image/png
1477
+
contentEncoding: base64
1479
1478
```
1480
1479
1481
1480
Note that the `Content-Type` remains `image/png`, describing the semantics of the payload. The JSON Schema `type` and `contentEncoding` fields explain that the payload is transferred as text. The JSON Schema `contentMediaType` is technically redundant, but can be used by JSON Schema tools that may not be aware of the OpenAPI context.
@@ -1704,7 +1703,7 @@ A 200 response for a successful operation and a default response for others (imp
1704
1703
```yaml
1705
1704
'200':
1706
1705
description: a pet to be returned
1707
-
content:
1706
+
content:
1708
1707
application/json:
1709
1708
schema:
1710
1709
$ref: '#/components/schemas/Pet'
@@ -1752,9 +1751,9 @@ Response of an array of a complex type:
0 commit comments