Swagger AccessToken fixes (#16574)

There is a subtle problem with the Swagger definition for AccessTokens which causes
autogeneration of APIs for these endpoints to fail.

This PR corrects these errors.

Ref: https://github.com/zeripath/java-gitea-api/issues/4
Signed-off-by: Andrew Thornton <art27@cantab.net>

Co-authored-by: techknowlogick <techknowlogick@gitea.io>
tokarchuk/v1.17
zeripath 3 years ago committed by GitHub
parent e51c73ae5c
commit 48c7c880b8
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
  1. 7
      routers/api/v1/swagger/app.go
  2. 3
      routers/api/v1/swagger/options.go
  3. 9
      routers/api/v1/user/app.go
  4. 39
      templates/swagger/v1_json.tmpl

@ -14,3 +14,10 @@ type swaggerResponseOAuth2Application struct {
// in:body // in:body
Body api.OAuth2Application `json:"body"` Body api.OAuth2Application `json:"body"`
} }
// AccessToken represents an API access token.
// swagger:response AccessToken
type swaggerResponseAccessToken struct {
// in:body
Body api.AccessToken `json:"body"`
}

@ -164,6 +164,9 @@ type swaggerParameterBodies struct {
// in:body // in:body
CreateTagOption api.CreateTagOption CreateTagOption api.CreateTagOption
// in:body
CreateAccessTokenOption api.CreateAccessTokenOption
// in:body // in:body
UserSettingsOptions api.UserSettingsOptions UserSettingsOptions api.UserSettingsOptions
} }

@ -76,15 +76,10 @@ func CreateAccessToken(ctx *context.APIContext) {
// description: username of user // description: username of user
// type: string // type: string
// required: true // required: true
// - name: accessToken // - name: userCreateToken
// in: body // in: body
// schema: // schema:
// type: object // "$ref": "#/definitions/CreateAccessTokenOption"
// required:
// - name
// properties:
// name:
// type: string
// responses: // responses:
// "201": // "201":
// "$ref": "#/responses/AccessToken" // "$ref": "#/responses/AccessToken"

@ -11917,18 +11917,10 @@
"required": true "required": true
}, },
{ {
"name": "accessToken", "name": "userCreateToken",
"in": "body", "in": "body",
"schema": { "schema": {
"type": "object", "$ref": "#/definitions/CreateAccessTokenOption"
"required": [
"name"
],
"properties": {
"name": {
"type": "string"
}
}
} }
} }
], ],
@ -12654,6 +12646,17 @@
}, },
"x-go-package": "code.gitea.io/gitea/modules/structs" "x-go-package": "code.gitea.io/gitea/modules/structs"
}, },
"CreateAccessTokenOption": {
"description": "CreateAccessTokenOption options when create access token",
"type": "object",
"properties": {
"name": {
"type": "string",
"x-go-name": "Name"
}
},
"x-go-package": "code.gitea.io/gitea/modules/structs"
},
"CreateBranchProtectionOption": { "CreateBranchProtectionOption": {
"description": "CreateBranchProtectionOption options for creating a branch protection", "description": "CreateBranchProtectionOption options for creating a branch protection",
"type": "object", "type": "object",
@ -17045,20 +17048,8 @@
"responses": { "responses": {
"AccessToken": { "AccessToken": {
"description": "AccessToken represents an API access token.", "description": "AccessToken represents an API access token.",
"headers": { "schema": {
"id": { "$ref": "#/definitions/AccessToken"
"type": "integer",
"format": "int64"
},
"name": {
"type": "string"
},
"sha1": {
"type": "string"
},
"token_last_eight": {
"type": "string"
}
} }
}, },
"AccessTokenList": { "AccessTokenList": {

Loading…
Cancel
Save