openapi.yaml 12 KB

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