openapi-spec.json 7.6 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323
  1. {
  2. "openapi": "3.0.0",
  3. "info": {
  4. "title": "Link Example",
  5. "version": "1.0.0"
  6. },
  7. "paths": {
  8. "/2.0/users/{username}": {
  9. "get": {
  10. "operationId": "getUserByName",
  11. "parameters": [
  12. {
  13. "name": "username",
  14. "in": "path",
  15. "required": true,
  16. "schema": {
  17. "type": "string"
  18. }
  19. }
  20. ],
  21. "responses": {
  22. "200": {
  23. "description": "The User",
  24. "content": {
  25. "application/json": {
  26. "schema": {
  27. "$ref": "#/components/schemas/user"
  28. }
  29. }
  30. },
  31. "links": {
  32. "userRepositories": {
  33. "$ref": "#/components/links/UserRepositories"
  34. }
  35. }
  36. }
  37. }
  38. }
  39. },
  40. "/2.0/repositories/{username}": {
  41. "get": {
  42. "operationId": "getRepositoriesByOwner",
  43. "parameters": [
  44. {
  45. "name": "username",
  46. "in": "path",
  47. "required": true,
  48. "schema": {
  49. "type": "string"
  50. }
  51. }
  52. ],
  53. "responses": {
  54. "200": {
  55. "description": "repositories owned by the supplied user",
  56. "content": {
  57. "application/json": {
  58. "schema": {
  59. "type": "array",
  60. "items": {
  61. "$ref": "#/components/schemas/repository"
  62. }
  63. }
  64. }
  65. },
  66. "links": {
  67. "userRepository": {
  68. "$ref": "#/components/links/UserRepository"
  69. }
  70. }
  71. }
  72. }
  73. }
  74. },
  75. "/2.0/repositories/{username}/{slug}": {
  76. "get": {
  77. "operationId": "getRepository",
  78. "parameters": [
  79. {
  80. "name": "username",
  81. "in": "path",
  82. "required": true,
  83. "schema": {
  84. "type": "string"
  85. }
  86. },
  87. {
  88. "name": "slug",
  89. "in": "path",
  90. "required": true,
  91. "schema": {
  92. "type": "string"
  93. }
  94. }
  95. ],
  96. "responses": {
  97. "200": {
  98. "description": "The repository",
  99. "content": {
  100. "application/json": {
  101. "schema": {
  102. "$ref": "#/components/schemas/repository"
  103. }
  104. }
  105. },
  106. "links": {
  107. "repositoryPullRequests": {
  108. "$ref": "#/components/links/RepositoryPullRequests"
  109. }
  110. }
  111. }
  112. }
  113. }
  114. },
  115. "/2.0/repositories/{username}/{slug}/pullrequests": {
  116. "get": {
  117. "operationId": "getPullRequestsByRepository",
  118. "parameters": [
  119. {
  120. "name": "username",
  121. "in": "path",
  122. "required": true,
  123. "schema": {
  124. "type": "string"
  125. }
  126. },
  127. {
  128. "name": "slug",
  129. "in": "path",
  130. "required": true,
  131. "schema": {
  132. "type": "string"
  133. }
  134. },
  135. {
  136. "name": "state",
  137. "in": "query",
  138. "schema": {
  139. "type": "string",
  140. "enum": [
  141. "open",
  142. "merged",
  143. "declined"
  144. ]
  145. }
  146. }
  147. ],
  148. "responses": {
  149. "200": {
  150. "description": "an array of pull request objects",
  151. "content": {
  152. "application/json": {
  153. "schema": {
  154. "type": "array",
  155. "items": {
  156. "$ref": "#/components/schemas/pullrequest"
  157. }
  158. }
  159. }
  160. }
  161. }
  162. }
  163. }
  164. },
  165. "/2.0/repositories/{username}/{slug}/pullrequests/{pid}": {
  166. "get": {
  167. "operationId": "getPullRequestsById",
  168. "parameters": [
  169. {
  170. "name": "username",
  171. "in": "path",
  172. "required": true,
  173. "schema": {
  174. "type": "string"
  175. }
  176. },
  177. {
  178. "name": "slug",
  179. "in": "path",
  180. "required": true,
  181. "schema": {
  182. "type": "string"
  183. }
  184. },
  185. {
  186. "name": "pid",
  187. "in": "path",
  188. "required": true,
  189. "schema": {
  190. "type": "string"
  191. }
  192. }
  193. ],
  194. "responses": {
  195. "200": {
  196. "description": "a pull request object",
  197. "content": {
  198. "application/json": {
  199. "schema": {
  200. "$ref": "#/components/schemas/pullrequest"
  201. }
  202. }
  203. },
  204. "links": {
  205. "pullRequestMerge": {
  206. "$ref": "#/components/links/PullRequestMerge"
  207. }
  208. }
  209. }
  210. }
  211. }
  212. },
  213. "/2.0/repositories/{username}/{slug}/pullrequests/{pid}/merge": {
  214. "post": {
  215. "operationId": "mergePullRequest",
  216. "parameters": [
  217. {
  218. "name": "username",
  219. "in": "path",
  220. "required": true,
  221. "schema": {
  222. "type": "string"
  223. }
  224. },
  225. {
  226. "name": "slug",
  227. "in": "path",
  228. "required": true,
  229. "schema": {
  230. "type": "string"
  231. }
  232. },
  233. {
  234. "name": "pid",
  235. "in": "path",
  236. "required": true,
  237. "schema": {
  238. "type": "string"
  239. }
  240. }
  241. ],
  242. "responses": {
  243. "204": {
  244. "description": "the PR was successfully merged"
  245. }
  246. }
  247. }
  248. }
  249. },
  250. "components": {
  251. "links": {
  252. "UserRepositories": {
  253. "operationId": "getRepositoriesByOwner",
  254. "parameters": {
  255. "username": "$response.body#/username"
  256. }
  257. },
  258. "UserRepository": {
  259. "operationId": "getRepository",
  260. "parameters": {
  261. "username": "$response.body#/owner/username",
  262. "slug": "$response.body#/slug"
  263. }
  264. },
  265. "RepositoryPullRequests": {
  266. "operationId": "getPullRequestsByRepository",
  267. "parameters": {
  268. "username": "$response.body#/owner/username",
  269. "slug": "$response.body#/slug"
  270. }
  271. },
  272. "PullRequestMerge": {
  273. "operationId": "mergePullRequest",
  274. "parameters": {
  275. "username": "$response.body#/author/username",
  276. "slug": "$response.body#/repository/slug",
  277. "pid": "$response.body#/id"
  278. }
  279. }
  280. },
  281. "schemas": {
  282. "user": {
  283. "type": "object",
  284. "properties": {
  285. "username": {
  286. "type": "string"
  287. },
  288. "uuid": {
  289. "type": "string"
  290. }
  291. }
  292. },
  293. "repository": {
  294. "type": "object",
  295. "properties": {
  296. "slug": {
  297. "type": "string"
  298. },
  299. "owner": {
  300. "$ref": "#/components/schemas/user"
  301. }
  302. }
  303. },
  304. "pullrequest": {
  305. "type": "object",
  306. "properties": {
  307. "id": {
  308. "type": "integer"
  309. },
  310. "title": {
  311. "type": "string"
  312. },
  313. "repository": {
  314. "$ref": "#/components/schemas/repository"
  315. },
  316. "author": {
  317. "$ref": "#/components/schemas/user"
  318. }
  319. }
  320. }
  321. }
  322. }
  323. }