File tree 3 files changed +1973
-947
lines changed
3 files changed +1973
-947
lines changed Original file line number Diff line number Diff line change 1
- * @ code42/literally-skynet
1
+ * @ code42/tbc
Original file line number Diff line number Diff line change @@ -37,6 +37,7 @@ the format we are using is OpenAPI version 3 as yml.
37
37
38
38
You can convert existing JSON Swagger v2 swagger using https://editor.swagger.io/ .
39
39
40
+ ## Troubleshooting
40
41
Some minor editing might be required to get the conversion to work. For example, warnings may appears on the left
41
42
margin of the Swagger editor. Address all the warnings before re-attempting the conversion.
42
43
A common problem from our docs is that the conversion tool does not like having ` descriptions `
@@ -57,7 +58,11 @@ with just:
57
58
58
59
You may also have issues with enum values. See the section below.
59
60
60
- ## Endpoint Enums
61
+ ### \* /\* Content Types
62
+ Sometimes the swagger editor will specify endpoints with */* content types, but those don't play nice with the mock servers.
63
+ Specify an explicit content type instead.
64
+
65
+ ### Endpoint Enums
61
66
62
67
Another common problem is that our Code42 docs often declare enums as having a type of ` integer`.
63
68
This will cause failures in Prism. Change the enum type to `string`. This is also needed for the conversion
You can’t perform that action at this time.
0 commit comments