openapi.yaml 12 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326
  1. openapi: 3.0.3
  2. info:
  3. title: Laravel
  4. description: ''
  5. version: 3.9.9
  6. servers:
  7. -
  8. url: 'http://localhost'
  9. paths:
  10. /api/withFormDataParams:
  11. post:
  12. summary: 'Endpoint with body form data parameters.'
  13. description: ''
  14. operationId: endpointWithBodyFormDataParameters
  15. parameters:
  16. -
  17. in: header
  18. name: Custom-Header
  19. description: ''
  20. example: NotSoCustom
  21. schema:
  22. type: string
  23. -
  24. in: header
  25. name: Content-Type
  26. description: ''
  27. example: multipart/form-data
  28. schema:
  29. type: string
  30. responses: { }
  31. tags:
  32. - 'Group A'
  33. requestBody:
  34. required: true
  35. content:
  36. multipart/form-data:
  37. schema:
  38. type: object
  39. properties:
  40. name:
  41. type: string
  42. description: 'Name of image.'
  43. example: cat.jpg
  44. image:
  45. type: string
  46. format: binary
  47. description: 'The image.'
  48. required:
  49. - name
  50. - image
  51. security: []
  52. /api/withResponseTag:
  53. get:
  54. summary: ''
  55. description: ''
  56. operationId: getApiWithResponseTag
  57. parameters:
  58. -
  59. in: header
  60. name: Custom-Header
  61. description: ''
  62. example: NotSoCustom
  63. schema:
  64. type: string
  65. responses:
  66. 200:
  67. description: ""
  68. content:
  69. application/json:
  70. schema:
  71. type: object
  72. example:
  73. id: 4
  74. name: banana
  75. color: red
  76. weight: '1 kg'
  77. delicious: true
  78. responseTag: true
  79. properties:
  80. id: { type: integer, example: 4 }
  81. name: { type: string, example: banana }
  82. color: { type: string, example: red }
  83. weight: { type: string, example: '1 kg' }
  84. delicious: { type: boolean, example: true }
  85. responseTag: { type: boolean, example: true }
  86. tags:
  87. - 'Group A'
  88. security: []
  89. /api/withQueryParameters:
  90. get:
  91. summary: ''
  92. description: ''
  93. operationId: getApiWithQueryParameters
  94. parameters:
  95. -
  96. in: query
  97. name: location_id
  98. description: 'The id of the location.'
  99. example: consequatur
  100. required: true
  101. schema:
  102. type: string
  103. description: 'The id of the location.'
  104. example: consequatur
  105. -
  106. in: query
  107. name: user_id
  108. description: 'The id of the user.'
  109. example: me
  110. required: true
  111. schema:
  112. type: string
  113. description: 'The id of the user.'
  114. example: me
  115. -
  116. in: query
  117. name: page
  118. description: 'The page number.'
  119. example: '4'
  120. required: true
  121. schema:
  122. type: string
  123. description: 'The page number.'
  124. example: '4'
  125. -
  126. in: query
  127. name: filters
  128. description: 'The filters.'
  129. example: consequatur
  130. required: false
  131. schema:
  132. type: string
  133. description: 'The filters.'
  134. example: consequatur
  135. -
  136. in: query
  137. name: url_encoded
  138. description: 'Used for testing that URL parameters will be URL-encoded where needed.'
  139. example: '+ []&='
  140. required: false
  141. schema:
  142. type: string
  143. description: 'Used for testing that URL parameters will be URL-encoded where needed.'
  144. example: '+ []&='
  145. -
  146. in: header
  147. name: Custom-Header
  148. description: ''
  149. example: NotSoCustom
  150. schema:
  151. type: string
  152. responses:
  153. 200:
  154. description: ""
  155. content:
  156. 'text/plain':
  157. schema:
  158. type: "string"
  159. example: ""
  160. tags:
  161. - 'Group A'
  162. security: []
  163. /api/withAuthTag:
  164. get:
  165. summary: ''
  166. description: ''
  167. operationId: getApiWithAuthTag
  168. parameters:
  169. -
  170. in: header
  171. name: Custom-Header
  172. description: ''
  173. example: NotSoCustom
  174. schema:
  175. type: string
  176. responses:
  177. 200:
  178. description: ""
  179. content:
  180. 'text/plain':
  181. schema:
  182. type: "string"
  183. example: ""
  184. tags:
  185. - 'Group A'
  186. '/api/echoesUrlParameters/{param}/{param2}/{param3}/{param4}':
  187. get:
  188. summary: ''
  189. description: ''
  190. operationId: getApiEchoesUrlParametersParamParam2Param3Param4
  191. parameters:
  192. -
  193. in: query
  194. name: something
  195. description: ''
  196. example: consequatur
  197. required: false
  198. schema:
  199. type: string
  200. description: ''
  201. example: consequatur
  202. -
  203. in: header
  204. name: Custom-Header
  205. description: ''
  206. example: NotSoCustom
  207. schema:
  208. type: string
  209. responses:
  210. 200:
  211. description: ''
  212. content:
  213. application/json:
  214. schema:
  215. type: object
  216. example:
  217. param: '4'
  218. param2: consequatur
  219. param3: consequatur
  220. param4: null
  221. properties:
  222. param: { type: string, example: '4' }
  223. param2: { type: string, example: consequatur }
  224. param3: { type: string, example: consequatur }
  225. param4: { type: string, example: null }
  226. tags:
  227. - Other😎
  228. security: []
  229. parameters:
  230. -
  231. in: path
  232. name: param
  233. description: ''
  234. example: '4'
  235. required: true
  236. schema:
  237. type: string
  238. -
  239. in: path
  240. name: param2
  241. description: ''
  242. required: true
  243. schema:
  244. type: string
  245. example: consequatur
  246. -
  247. in: path
  248. name: param3
  249. description: 'Optional parameter.'
  250. required: true
  251. schema:
  252. type: string
  253. examples:
  254. omitted:
  255. summary: 'When the value is omitted'
  256. value: ''
  257. present:
  258. summary: 'When the value is present'
  259. value: consequatur
  260. -
  261. in: path
  262. name: param4
  263. description: 'Optional parameter.'
  264. required: true
  265. schema:
  266. type: string
  267. examples:
  268. omitted:
  269. summary: 'When the value is omitted'
  270. value: ''
  271. /api/withBodyParametersAsArray:
  272. post:
  273. summary: 'Endpoint with body parameters as array.'
  274. description: ''
  275. operationId: endpointWithBodyParametersAsArray
  276. parameters:
  277. - in: header
  278. name: Custom-Header
  279. description: ''
  280. example: NotSoCustom
  281. schema:
  282. type: string
  283. - in: header
  284. name: Content-Type
  285. description: ''
  286. example: application/json
  287. schema:
  288. type: string
  289. responses: {}
  290. tags:
  291. - Group A
  292. requestBody:
  293. required: true
  294. content:
  295. application/json:
  296. schema:
  297. type: array
  298. description: Details.
  299. example:
  300. - first_name: 'John'
  301. last_name: 'Doe'
  302. contacts:
  303. - first_name: Janelle
  304. last_name: Monáe
  305. roles: [Admin]
  306. items:
  307. type: object
  308. properties:
  309. first_name: { type: string, description: 'The first name of the user.', example: John }
  310. last_name: { type: string, description: 'The last name of the user.', example: Doe }
  311. contacts: { type: array, description: 'Contact info', example: [ [ ] ], items: { type: object, properties: { first_name: { type: string, description: 'The first name of the contact.', example: Janelle }, last_name: { type: string, description: 'The last name of the contact.', example: Monáe } }, required: [ first_name, last_name ] } }
  312. roles: { type: array, description: 'The name of the role.', example: [ Admin ], items: { type: string } }
  313. required:
  314. - first_name
  315. - last_name
  316. - contacts
  317. - roles
  318. security: [ ]
  319. tags:
  320. -
  321. name: 'Group A'
  322. description: ''
  323. -
  324. name: Other😎
  325. description: ''