| 123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323 |
- {
- "openapi": "3.0.0",
- "info": {
- "title": "Link Example",
- "version": "1.0.0"
- },
- "paths": {
- "/2.0/users/{username}": {
- "get": {
- "operationId": "getUserByName",
- "parameters": [
- {
- "name": "username",
- "in": "path",
- "required": true,
- "schema": {
- "type": "string"
- }
- }
- ],
- "responses": {
- "200": {
- "description": "The User",
- "content": {
- "application/json": {
- "schema": {
- "$ref": "#/components/schemas/user"
- }
- }
- },
- "links": {
- "userRepositories": {
- "$ref": "#/components/links/UserRepositories"
- }
- }
- }
- }
- }
- },
- "/2.0/repositories/{username}": {
- "get": {
- "operationId": "getRepositoriesByOwner",
- "parameters": [
- {
- "name": "username",
- "in": "path",
- "required": true,
- "schema": {
- "type": "string"
- }
- }
- ],
- "responses": {
- "200": {
- "description": "repositories owned by the supplied user",
- "content": {
- "application/json": {
- "schema": {
- "type": "array",
- "items": {
- "$ref": "#/components/schemas/repository"
- }
- }
- }
- },
- "links": {
- "userRepository": {
- "$ref": "#/components/links/UserRepository"
- }
- }
- }
- }
- }
- },
- "/2.0/repositories/{username}/{slug}": {
- "get": {
- "operationId": "getRepository",
- "parameters": [
- {
- "name": "username",
- "in": "path",
- "required": true,
- "schema": {
- "type": "string"
- }
- },
- {
- "name": "slug",
- "in": "path",
- "required": true,
- "schema": {
- "type": "string"
- }
- }
- ],
- "responses": {
- "200": {
- "description": "The repository",
- "content": {
- "application/json": {
- "schema": {
- "$ref": "#/components/schemas/repository"
- }
- }
- },
- "links": {
- "repositoryPullRequests": {
- "$ref": "#/components/links/RepositoryPullRequests"
- }
- }
- }
- }
- }
- },
- "/2.0/repositories/{username}/{slug}/pullrequests": {
- "get": {
- "operationId": "getPullRequestsByRepository",
- "parameters": [
- {
- "name": "username",
- "in": "path",
- "required": true,
- "schema": {
- "type": "string"
- }
- },
- {
- "name": "slug",
- "in": "path",
- "required": true,
- "schema": {
- "type": "string"
- }
- },
- {
- "name": "state",
- "in": "query",
- "schema": {
- "type": "string",
- "enum": [
- "open",
- "merged",
- "declined"
- ]
- }
- }
- ],
- "responses": {
- "200": {
- "description": "an array of pull request objects",
- "content": {
- "application/json": {
- "schema": {
- "type": "array",
- "items": {
- "$ref": "#/components/schemas/pullrequest"
- }
- }
- }
- }
- }
- }
- }
- },
- "/2.0/repositories/{username}/{slug}/pullrequests/{pid}": {
- "get": {
- "operationId": "getPullRequestsById",
- "parameters": [
- {
- "name": "username",
- "in": "path",
- "required": true,
- "schema": {
- "type": "string"
- }
- },
- {
- "name": "slug",
- "in": "path",
- "required": true,
- "schema": {
- "type": "string"
- }
- },
- {
- "name": "pid",
- "in": "path",
- "required": true,
- "schema": {
- "type": "string"
- }
- }
- ],
- "responses": {
- "200": {
- "description": "a pull request object",
- "content": {
- "application/json": {
- "schema": {
- "$ref": "#/components/schemas/pullrequest"
- }
- }
- },
- "links": {
- "pullRequestMerge": {
- "$ref": "#/components/links/PullRequestMerge"
- }
- }
- }
- }
- }
- },
- "/2.0/repositories/{username}/{slug}/pullrequests/{pid}/merge": {
- "post": {
- "operationId": "mergePullRequest",
- "parameters": [
- {
- "name": "username",
- "in": "path",
- "required": true,
- "schema": {
- "type": "string"
- }
- },
- {
- "name": "slug",
- "in": "path",
- "required": true,
- "schema": {
- "type": "string"
- }
- },
- {
- "name": "pid",
- "in": "path",
- "required": true,
- "schema": {
- "type": "string"
- }
- }
- ],
- "responses": {
- "204": {
- "description": "the PR was successfully merged"
- }
- }
- }
- }
- },
- "components": {
- "links": {
- "UserRepositories": {
- "operationId": "getRepositoriesByOwner",
- "parameters": {
- "username": "$response.body#/username"
- }
- },
- "UserRepository": {
- "operationId": "getRepository",
- "parameters": {
- "username": "$response.body#/owner/username",
- "slug": "$response.body#/slug"
- }
- },
- "RepositoryPullRequests": {
- "operationId": "getPullRequestsByRepository",
- "parameters": {
- "username": "$response.body#/owner/username",
- "slug": "$response.body#/slug"
- }
- },
- "PullRequestMerge": {
- "operationId": "mergePullRequest",
- "parameters": {
- "username": "$response.body#/author/username",
- "slug": "$response.body#/repository/slug",
- "pid": "$response.body#/id"
- }
- }
- },
- "schemas": {
- "user": {
- "type": "object",
- "properties": {
- "username": {
- "type": "string"
- },
- "uuid": {
- "type": "string"
- }
- }
- },
- "repository": {
- "type": "object",
- "properties": {
- "slug": {
- "type": "string"
- },
- "owner": {
- "$ref": "#/components/schemas/user"
- }
- }
- },
- "pullrequest": {
- "type": "object",
- "properties": {
- "id": {
- "type": "integer"
- },
- "title": {
- "type": "string"
- },
- "repository": {
- "$ref": "#/components/schemas/repository"
- },
- "author": {
- "$ref": "#/components/schemas/user"
- }
- }
- }
- }
- }
- }
|