diff options
| author |  Vyr Cossont <vyr@noreply.codeberg.org> | 2025-11-11 19:39:09 +0100 |
|---|---|---|
| committer |  tobi <tobi.smethurst@protonmail.com> | 2025-11-17 14:15:04 +0100 |
| commit | 0c7b069c4a09f01a3a6c59bd7b66f096f8dcec40 (patch) | |
| tree | e5306d5ebad1e5a6efe5393bfafde95f5b94b237 /internal | |
| parent | [performance] remove hard reliance on .Cached field to indicate whether media... (diff) | |
| download | gotosocial-0c7b069c4a09f01a3a6c59bd7b66f096f8dcec40.tar.xz | |
[chore] Apply schema for OpenAPI errors (#4511)
Adds an error struct to Swagger covering normal and OAuth errors for client API endpoints. Now clients using Swagger codegen can handle errors.
Specifically, if you _don't_ have typed errors in your Swagger IDL and you're using `go-swagger` to generate your API client, the error message is discarded and you are only told the status code. With this change in place, clients like `slurp` can tell the user that they tried to upload an emoji that was too big or whatever.
Reviewed-on: https://codeberg.org/superseriousbusiness/gotosocial/pulls/4511
Reviewed-by: tobi <kipvandenbos@noreply.codeberg.org>
Co-authored-by: Vyr Cossont <vyr@noreply.codeberg.org>
Co-committed-by: Vyr Cossont <vyr@noreply.codeberg.org>
Diffstat (limited to 'internal')
210 files changed, 2317 insertions, 15 deletions
diff --git a/internal/api/activitypub/users/featured.go b/internal/api/activitypub/users/featured.go index 021e5aeb9..8bd261eb7 100644 --- a/internal/api/activitypub/users/featured.go +++ b/internal/api/activitypub/users/featured.go @@ -58,12 +58,20 @@ import ( // schema: // "$ref": "#/definitions/swaggerFeaturedCollection" // '400': +// schema: +// "$ref": "#/definitions/error" // description: bad request // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '403': +// schema: +// "$ref": "#/definitions/error" // description: forbidden // '404': +// schema: +// "$ref": "#/definitions/error" // description: not found func (m *Module) FeaturedCollectionGETHandler(c *gin.Context) { // usernames on our instance are always lowercase diff --git a/internal/api/activitypub/users/outboxget.go b/internal/api/activitypub/users/outboxget.go index a76834ce0..bbb266dea 100644 --- a/internal/api/activitypub/users/outboxget.go +++ b/internal/api/activitypub/users/outboxget.go @@ -75,12 +75,20 @@ import ( // schema: // "$ref": "#/definitions/swaggerCollection" // '400': +// schema: +// "$ref": "#/definitions/error" // description: bad request // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '403': +// schema: +// "$ref": "#/definitions/error" // description: forbidden // '404': +// schema: +// "$ref": "#/definitions/error" // description: not found func (m *Module) OutboxGETHandler(c *gin.Context) { // usernames on our instance are always lowercase diff --git a/internal/api/activitypub/users/repliesget.go b/internal/api/activitypub/users/repliesget.go index facbbcc85..f5f27e750 100644 --- a/internal/api/activitypub/users/repliesget.go +++ b/internal/api/activitypub/users/repliesget.go @@ -82,12 +82,20 @@ import ( // schema: // "$ref": "#/definitions/swaggerCollection" // '400': +// schema: +// "$ref": "#/definitions/error" // description: bad request // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '403': +// schema: +// "$ref": "#/definitions/error" // description: forbidden // '404': +// schema: +// "$ref": "#/definitions/error" // description: not found func (m *Module) StatusRepliesGETHandler(c *gin.Context) { // usernames on our instance are always lowercase diff --git a/internal/api/auth/revoke.go b/internal/api/auth/revoke.go index c5167889c..e0a1de793 100644 --- a/internal/api/auth/revoke.go +++ b/internal/api/auth/revoke.go @@ -66,13 +66,21 @@ import ( // OK - If you own the provided token, the API call will provide OK and an empty response `{}`. // This operation is idempotent, so calling this API multiple times will still return OK. // '400': +// schema: +// "$ref": "#/definitions/error" // description: bad request // '403': +// schema: +// "$ref": "#/definitions/error" // description: >- // forbidden - If you provide a token you do not own, the API call will return a 403 error. // '406': +// schema: +// "$ref": "#/definitions/error" // description: not acceptable // '500': +// schema: +// "$ref": "#/definitions/error" // description: internal server error func (m *Module) TokenRevokePOSTHandler(c *gin.Context) { if _, err := apiutil.NegotiateAccept(c, apiutil.JSONAcceptHeaders...); err != nil { diff --git a/internal/api/client/accounts/accountalias.go b/internal/api/client/accounts/accountalias.go index 51183bff7..ef802b5b1 100644 --- a/internal/api/client/accounts/accountalias.go +++ b/internal/api/client/accounts/accountalias.go @@ -64,16 +64,28 @@ import ( // schema: // "$ref": "#/definitions/account" // '400': +// schema: +// "$ref": "#/definitions/error" // description: bad request // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '404': +// schema: +// "$ref": "#/definitions/error" // description: not found // '406': +// schema: +// "$ref": "#/definitions/error" // description: not acceptable // '422': +// schema: +// "$ref": "#/definitions/error" // description: Unprocessable. Check the response body for more details. // '500': +// schema: +// "$ref": "#/definitions/error" // description: internal server error func (m *Module) AccountAliasPOSTHandler(c *gin.Context) { authed, errWithCode := apiutil.TokenAuth(c, diff --git a/internal/api/client/accounts/accountcreate.go b/internal/api/client/accounts/accountcreate.go index ef45c7529..d8da4470c 100644 --- a/internal/api/client/accounts/accountcreate.go +++ b/internal/api/client/accounts/accountcreate.go @@ -58,19 +58,31 @@ import ( // schema: // "$ref": "#/definitions/oauthToken" // '400': +// schema: +// "$ref": "#/definitions/error" // description: bad request // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '404': +// schema: +// "$ref": "#/definitions/error" // description: not found // '406': +// schema: +// "$ref": "#/definitions/error" // description: not acceptable // '422': +// schema: +// "$ref": "#/definitions/error" // description: >- // Unprocessable. Your account creation request cannot be processed // because either too many accounts have been created on this instance // in the last 24h, or the pending account backlog is full. // '500': +// schema: +// "$ref": "#/definitions/error" // description: internal server error func (m *Module) AccountCreatePOSTHandler(c *gin.Context) { authed, errWithCode := apiutil.TokenAuth(c, diff --git a/internal/api/client/accounts/accountdelete.go b/internal/api/client/accounts/accountdelete.go index e7682b2ce..27f0a428d 100644 --- a/internal/api/client/accounts/accountdelete.go +++ b/internal/api/client/accounts/accountdelete.go @@ -56,14 +56,24 @@ import ( // '202': // description: "The account deletion has been accepted and the account will be deleted." // '400': +// schema: +// "$ref": "#/definitions/error" // description: bad request // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '404': +// schema: +// "$ref": "#/definitions/error" // description: not found // '406': +// schema: +// "$ref": "#/definitions/error" // description: not acceptable // '500': +// schema: +// "$ref": "#/definitions/error" // description: internal server error func (m *Module) AccountDeletePOSTHandler(c *gin.Context) { authed, errWithCode := apiutil.TokenAuth(c, diff --git a/internal/api/client/accounts/accountget.go b/internal/api/client/accounts/accountget.go index c28635a86..158748189 100644 --- a/internal/api/client/accounts/accountget.go +++ b/internal/api/client/accounts/accountget.go @@ -55,14 +55,24 @@ import ( // schema: // "$ref": "#/definitions/account" // '400': +// schema: +// "$ref": "#/definitions/error" // description: bad request // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '404': +// schema: +// "$ref": "#/definitions/error" // description: not found // '406': +// schema: +// "$ref": "#/definitions/error" // description: not acceptable // '500': +// schema: +// "$ref": "#/definitions/error" // description: internal server error func (m *Module) AccountGETHandler(c *gin.Context) { authed, errWithCode := apiutil.TokenAuth(c, diff --git a/internal/api/client/accounts/accountmove.go b/internal/api/client/accounts/accountmove.go index cdb2cdddb..d95462f07 100644 --- a/internal/api/client/accounts/accountmove.go +++ b/internal/api/client/accounts/accountmove.go @@ -61,16 +61,28 @@ import ( // '202': // description: The account move has been accepted and the account will be moved. // '400': +// schema: +// "$ref": "#/definitions/error" // description: bad request // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '404': +// schema: +// "$ref": "#/definitions/error" // description: not found // '406': +// schema: +// "$ref": "#/definitions/error" // description: not acceptable // '422': +// schema: +// "$ref": "#/definitions/error" // description: Unprocessable. Check the response body for more details. // '500': +// schema: +// "$ref": "#/definitions/error" // description: internal server error func (m *Module) AccountMovePOSTHandler(c *gin.Context) { authed, errWithCode := apiutil.TokenAuth(c, diff --git a/internal/api/client/accounts/accountupdate.go b/internal/api/client/accounts/accountupdate.go index 58ba0dd2e..2514b2785 100644 --- a/internal/api/client/accounts/accountupdate.go +++ b/internal/api/client/accounts/accountupdate.go @@ -233,14 +233,24 @@ import ( // schema: // "$ref": "#/definitions/account" // '400': +// schema: +// "$ref": "#/definitions/error" // description: bad request // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '404': +// schema: +// "$ref": "#/definitions/error" // description: not found // '406': +// schema: +// "$ref": "#/definitions/error" // description: not acceptable // '500': +// schema: +// "$ref": "#/definitions/error" // description: internal server error func (m *Module) AccountUpdateCredentialsPATCHHandler(c *gin.Context) { authed, errWithCode := apiutil.TokenAuth(c, diff --git a/internal/api/client/accounts/accountverify.go b/internal/api/client/accounts/accountverify.go index dda3c10c6..d3722326f 100644 --- a/internal/api/client/accounts/accountverify.go +++ b/internal/api/client/accounts/accountverify.go @@ -45,14 +45,24 @@ import ( // schema: // "$ref": "#/definitions/account" // '400': +// schema: +// "$ref": "#/definitions/error" // description: bad request // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '404': +// schema: +// "$ref": "#/definitions/error" // description: not found // '406': +// schema: +// "$ref": "#/definitions/error" // description: not acceptable // '500': +// schema: +// "$ref": "#/definitions/error" // description: internal server error func (m *Module) AccountVerifyGETHandler(c *gin.Context) { authed, errWithCode := apiutil.TokenAuth(c, diff --git a/internal/api/client/accounts/block.go b/internal/api/client/accounts/block.go index 066ce0c31..3a625c671 100644 --- a/internal/api/client/accounts/block.go +++ b/internal/api/client/accounts/block.go @@ -55,14 +55,24 @@ import ( // schema: // "$ref": "#/definitions/accountRelationship" // '400': +// schema: +// "$ref": "#/definitions/error" // description: bad request // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '404': +// schema: +// "$ref": "#/definitions/error" // description: not found // '406': +// schema: +// "$ref": "#/definitions/error" // description: not acceptable // '500': +// schema: +// "$ref": "#/definitions/error" // description: internal server error func (m *Module) AccountBlockPOSTHandler(c *gin.Context) { authed, errWithCode := apiutil.TokenAuth(c, diff --git a/internal/api/client/accounts/featuredtags.go b/internal/api/client/accounts/featuredtags.go index eae3fbdf1..12a91922b 100644 --- a/internal/api/client/accounts/featuredtags.go +++ b/internal/api/client/accounts/featuredtags.go @@ -57,14 +57,24 @@ import ( // items: // type: object // '400': +// schema: +// "$ref": "#/definitions/error" // description: bad request // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '404': +// schema: +// "$ref": "#/definitions/error" // description: not found // '406': +// schema: +// "$ref": "#/definitions/error" // description: not acceptable // '500': +// schema: +// "$ref": "#/definitions/error" // description: internal server error func (m *Module) AccountFeaturedTagsGETHandler(c *gin.Context) { _, errWithCode := apiutil.TokenAuth(c, diff --git a/internal/api/client/accounts/follow.go b/internal/api/client/accounts/follow.go index e89cfc40f..886a87c58 100644 --- a/internal/api/client/accounts/follow.go +++ b/internal/api/client/accounts/follow.go @@ -80,14 +80,24 @@ import ( // schema: // "$ref": "#/definitions/accountRelationship" // '400': +// schema: +// "$ref": "#/definitions/error" // description: bad request // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '404': +// schema: +// "$ref": "#/definitions/error" // description: not found // '406': +// schema: +// "$ref": "#/definitions/error" // description: not acceptable // '500': +// schema: +// "$ref": "#/definitions/error" // description: internal server error func (m *Module) AccountFollowPOSTHandler(c *gin.Context) { authed, errWithCode := apiutil.TokenAuth(c, diff --git a/internal/api/client/accounts/followers.go b/internal/api/client/accounts/followers.go index a813e9f00..4f9d611ff 100644 --- a/internal/api/client/accounts/followers.go +++ b/internal/api/client/accounts/followers.go @@ -108,14 +108,24 @@ import ( // type: string // description: Links to the next and previous queries. // '400': +// schema: +// "$ref": "#/definitions/error" // description: bad request // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '404': +// schema: +// "$ref": "#/definitions/error" // description: not found // '406': +// schema: +// "$ref": "#/definitions/error" // description: not acceptable // '500': +// schema: +// "$ref": "#/definitions/error" // description: internal server error func (m *Module) AccountFollowersGETHandler(c *gin.Context) { authed, errWithCode := apiutil.TokenAuth(c, diff --git a/internal/api/client/accounts/following.go b/internal/api/client/accounts/following.go index 694e95ccd..1cb367224 100644 --- a/internal/api/client/accounts/following.go +++ b/internal/api/client/accounts/following.go @@ -108,14 +108,24 @@ import ( // type: string // description: Links to the next and previous queries. // '400': +// schema: +// "$ref": "#/definitions/error" // description: bad request // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '404': +// schema: +// "$ref": "#/definitions/error" // description: not found // '406': +// schema: +// "$ref": "#/definitions/error" // description: not acceptable // '500': +// schema: +// "$ref": "#/definitions/error" // description: internal server error func (m *Module) AccountFollowingGETHandler(c *gin.Context) { authed, errWithCode := apiutil.TokenAuth(c, diff --git a/internal/api/client/accounts/lists.go b/internal/api/client/accounts/lists.go index 23a137533..dc918f0bc 100644 --- a/internal/api/client/accounts/lists.go +++ b/internal/api/client/accounts/lists.go @@ -58,14 +58,24 @@ import ( // items: // "$ref": "#/definitions/list" // '400': +// schema: +// "$ref": "#/definitions/error" // description: bad request // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '404': +// schema: +// "$ref": "#/definitions/error" // description: not found // '406': +// schema: +// "$ref": "#/definitions/error" // description: not acceptable // '500': +// schema: +// "$ref": "#/definitions/error" // description: internal server error func (m *Module) AccountListsGETHandler(c *gin.Context) { authed, errWithCode := apiutil.TokenAuth(c, diff --git a/internal/api/client/accounts/lookup.go b/internal/api/client/accounts/lookup.go index 03657a20a..87fcb762f 100644 --- a/internal/api/client/accounts/lookup.go +++ b/internal/api/client/accounts/lookup.go @@ -55,14 +55,24 @@ import ( // schema: // "$ref": "#/definitions/account" // '400': +// schema: +// "$ref": "#/definitions/error" // description: bad request // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '404': +// schema: +// "$ref": "#/definitions/error" // description: not found // '406': +// schema: +// "$ref": "#/definitions/error" // description: not acceptable // '500': +// schema: +// "$ref": "#/definitions/error" // description: internal server error func (m *Module) AccountLookupGETHandler(c *gin.Context) { authed, errWithCode := apiutil.TokenAuth(c, diff --git a/internal/api/client/accounts/mute.go b/internal/api/client/accounts/mute.go index e9884eafd..0a3b65a57 100644 --- a/internal/api/client/accounts/mute.go +++ b/internal/api/client/accounts/mute.go @@ -73,16 +73,28 @@ import ( // schema: // "$ref": "#/definitions/accountRelationship" // '400': +// schema: +// "$ref": "#/definitions/error" // description: bad request // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '403': +// schema: +// "$ref": "#/definitions/error" // description: forbidden to moved accounts // '404': +// schema: +// "$ref": "#/definitions/error" // description: not found // '406': +// schema: +// "$ref": "#/definitions/error" // description: not acceptable // '500': +// schema: +// "$ref": "#/definitions/error" // description: internal server error func (m *Module) AccountMutePOSTHandler(c *gin.Context) { authed, errWithCode := apiutil.TokenAuth(c, diff --git a/internal/api/client/accounts/note.go b/internal/api/client/accounts/note.go index 2461487e8..f73a39c40 100644 --- a/internal/api/client/accounts/note.go +++ b/internal/api/client/accounts/note.go @@ -64,14 +64,24 @@ import ( // schema: // "$ref": "#/definitions/accountRelationship" // '400': +// schema: +// "$ref": "#/definitions/error" // description: bad request // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '404': +// schema: +// "$ref": "#/definitions/error" // description: not found // '406': +// schema: +// "$ref": "#/definitions/error" // description: not acceptable // '500': +// schema: +// "$ref": "#/definitions/error" // description: internal server error func (m *Module) AccountNotePOSTHandler(c *gin.Context) { authed, errWithCode := apiutil.TokenAuth(c, diff --git a/internal/api/client/accounts/profile.go b/internal/api/client/accounts/profile.go index 6f9194ba9..17105d656 100644 --- a/internal/api/client/accounts/profile.go +++ b/internal/api/client/accounts/profile.go @@ -50,14 +50,24 @@ import ( // schema: // "$ref": "#/definitions/account" // '400': +// schema: +// "$ref": "#/definitions/error" // description: bad request // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '403': +// schema: +// "$ref": "#/definitions/error" // description: forbidden // '406': +// schema: +// "$ref": "#/definitions/error" // description: not acceptable // '500': +// schema: +// "$ref": "#/definitions/error" // description: internal server error func (m *Module) AccountAvatarDELETEHandler(c *gin.Context) { m.accountDeleteProfileAttachment(c, m.processor.Media().DeleteAvatar) @@ -85,14 +95,24 @@ func (m *Module) AccountAvatarDELETEHandler(c *gin.Context) { // schema: // "$ref": "#/definitions/account" // '400': +// schema: +// "$ref": "#/definitions/error" // description: bad request // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '403': +// schema: +// "$ref": "#/definitions/error" // description: forbidden // '406': +// schema: +// "$ref": "#/definitions/error" // description: not acceptable // '500': +// schema: +// "$ref": "#/definitions/error" // description: internal server error func (m *Module) AccountHeaderDELETEHandler(c *gin.Context) { m.accountDeleteProfileAttachment(c, m.processor.Media().DeleteHeader) diff --git a/internal/api/client/accounts/relationships.go b/internal/api/client/accounts/relationships.go index 33a8c20d9..81eda8559 100644 --- a/internal/api/client/accounts/relationships.go +++ b/internal/api/client/accounts/relationships.go @@ -62,14 +62,24 @@ import ( // items: // "$ref": "#/definitions/accountRelationship" // '400': +// schema: +// "$ref": "#/definitions/error" // description: bad request // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '404': +// schema: +// "$ref": "#/definitions/error" // description: not found // '406': +// schema: +// "$ref": "#/definitions/error" // description: not acceptable // '500': +// schema: +// "$ref": "#/definitions/error" // description: internal server error func (m *Module) AccountRelationshipsGETHandler(c *gin.Context) { authed, errWithCode := apiutil.TokenAuth(c, diff --git a/internal/api/client/accounts/search.go b/internal/api/client/accounts/search.go index 1c3166c29..4a86374ca 100644 --- a/internal/api/client/accounts/search.go +++ b/internal/api/client/accounts/search.go @@ -96,14 +96,24 @@ import ( // items: // "$ref": "#/definitions/account" // '400': +// schema: +// "$ref": "#/definitions/error" // description: bad request // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '404': +// schema: +// "$ref": "#/definitions/error" // description: not found // '406': +// schema: +// "$ref": "#/definitions/error" // description: not acceptable // '500': +// schema: +// "$ref": "#/definitions/error" // description: internal server error func (m *Module) AccountSearchGETHandler(c *gin.Context) { authed, errWithCode := apiutil.TokenAuth(c, diff --git a/internal/api/client/accounts/statuses.go b/internal/api/client/accounts/statuses.go index 9cfb7db85..2d712d554 100644 --- a/internal/api/client/accounts/statuses.go +++ b/internal/api/client/accounts/statuses.go @@ -123,14 +123,24 @@ import ( // type: string // description: Links to the next and previous queries. // '400': +// schema: +// "$ref": "#/definitions/error" // description: bad request // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '404': +// schema: +// "$ref": "#/definitions/error" // description: not found // '406': +// schema: +// "$ref": "#/definitions/error" // description: not acceptable // '500': +// schema: +// "$ref": "#/definitions/error" // description: internal server error func (m *Module) AccountStatusesGETHandler(c *gin.Context) { authed, errWithCode := apiutil.TokenAuth(c, diff --git a/internal/api/client/accounts/themesget.go b/internal/api/client/accounts/themesget.go index f1204e85e..06dcf9a7b 100644 --- a/internal/api/client/accounts/themesget.go +++ b/internal/api/client/accounts/themesget.go @@ -49,14 +49,24 @@ import ( // items: // "$ref": "#/definitions/theme" // '400': +// schema: +// "$ref": "#/definitions/error" // description: bad request // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '404': +// schema: +// "$ref": "#/definitions/error" // description: not found // '406': +// schema: +// "$ref": "#/definitions/error" // description: not acceptable // '500': +// schema: +// "$ref": "#/definitions/error" // description: internal server error func (m *Module) AccountThemesGETHandler(c *gin.Context) { _, errWithCode := apiutil.TokenAuth(c, diff --git a/internal/api/client/accounts/unblock.go b/internal/api/client/accounts/unblock.go index 0f725967f..9e111f86b 100644 --- a/internal/api/client/accounts/unblock.go +++ b/internal/api/client/accounts/unblock.go @@ -56,14 +56,24 @@ import ( // schema: // "$ref": "#/definitions/accountRelationship" // '400': +// schema: +// "$ref": "#/definitions/error" // description: bad request // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '404': +// schema: +// "$ref": "#/definitions/error" // description: not found // '406': +// schema: +// "$ref": "#/definitions/error" // description: not acceptable // '500': +// schema: +// "$ref": "#/definitions/error" // description: internal server error func (m *Module) AccountUnblockPOSTHandler(c *gin.Context) { authed, errWithCode := apiutil.TokenAuth(c, true, true, true, true) diff --git a/internal/api/client/accounts/unfollow.go b/internal/api/client/accounts/unfollow.go index 458232b73..f87f8aa9e 100644 --- a/internal/api/client/accounts/unfollow.go +++ b/internal/api/client/accounts/unfollow.go @@ -56,14 +56,24 @@ import ( // schema: // "$ref": "#/definitions/accountRelationship" // '400': +// schema: +// "$ref": "#/definitions/error" // description: bad request // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '404': +// schema: +// "$ref": "#/definitions/error" // description: not found // '406': +// schema: +// "$ref": "#/definitions/error" // description: not acceptable // '500': +// schema: +// "$ref": "#/definitions/error" // description: internal server error func (m *Module) AccountUnfollowPOSTHandler(c *gin.Context) { authed, errWithCode := apiutil.TokenAuth(c, diff --git a/internal/api/client/accounts/unmute.go b/internal/api/client/accounts/unmute.go index eaee047f7..539fcfa11 100644 --- a/internal/api/client/accounts/unmute.go +++ b/internal/api/client/accounts/unmute.go @@ -58,14 +58,24 @@ import ( // schema: // "$ref": "#/definitions/accountRelationship" // '400': +// schema: +// "$ref": "#/definitions/error" // description: bad request // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '404': +// schema: +// "$ref": "#/definitions/error" // description: not found // '406': +// schema: +// "$ref": "#/definitions/error" // description: not acceptable // '500': +// schema: +// "$ref": "#/definitions/error" // description: internal server error func (m *Module) AccountUnmutePOSTHandler(c *gin.Context) { authed, errWithCode := apiutil.TokenAuth(c, diff --git a/internal/api/client/admin/accountaction.go b/internal/api/client/admin/accountaction.go index 290d80b71..ab68ed3ed 100644 --- a/internal/api/client/admin/accountaction.go +++ b/internal/api/client/admin/accountaction.go @@ -69,21 +69,35 @@ import ( // '200': // description: OK // '400': +// schema: +// "$ref": "#/definitions/error" // description: bad request // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '403': +// schema: +// "$ref": "#/definitions/error" // description: forbidden // '404': +// schema: +// "$ref": "#/definitions/error" // description: not found // '406': +// schema: +// "$ref": "#/definitions/error" // description: not acceptable // '409': +// schema: +// "$ref": "#/definitions/error" // description: >- // Conflict: There is already an admin action running that conflicts with this action. // Check the error message in the response body for more information. This is a temporary // error; it should be possible to process this action if you try again in a bit. // '500': +// schema: +// "$ref": "#/definitions/error" // description: internal server error func (m *Module) AccountActionPOSTHandler(c *gin.Context) { authed, errWithCode := apiutil.TokenAuth(c, diff --git a/internal/api/client/admin/accountapprove.go b/internal/api/client/admin/accountapprove.go index f5838f9d9..521b247a6 100644 --- a/internal/api/client/admin/accountapprove.go +++ b/internal/api/client/admin/accountapprove.go @@ -55,16 +55,28 @@ import ( // schema: // "$ref": "#/definitions/adminAccountInfo" // '400': +// schema: +// "$ref": "#/definitions/error" // description: bad request // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '403': +// schema: +// "$ref": "#/definitions/error" // description: forbidden // '404': +// schema: +// "$ref": "#/definitions/error" // description: not found // '406': +// schema: +// "$ref": "#/definitions/error" // description: not acceptable // '500': +// schema: +// "$ref": "#/definitions/error" // description: internal server error func (m *Module) AccountApprovePOSTHandler(c *gin.Context) { authed, errWithCode := apiutil.TokenAuth(c, diff --git a/internal/api/client/admin/accountget.go b/internal/api/client/admin/accountget.go index 75659777c..43f53887c 100644 --- a/internal/api/client/admin/accountget.go +++ b/internal/api/client/admin/accountget.go @@ -55,16 +55,28 @@ import ( // schema: // "$ref": "#/definitions/adminAccountInfo" // '400': +// schema: +// "$ref": "#/definitions/error" // description: bad request // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '403': +// schema: +// "$ref": "#/definitions/error" // description: forbidden // '404': +// schema: +// "$ref": "#/definitions/error" // description: not found // '406': +// schema: +// "$ref": "#/definitions/error" // description: not acceptable // '500': +// schema: +// "$ref": "#/definitions/error" // description: internal server error func (m *Module) AccountGETHandler(c *gin.Context) { authed, errWithCode := apiutil.TokenAuth(c, diff --git a/internal/api/client/admin/accountreject.go b/internal/api/client/admin/accountreject.go index d9651c792..50d4ef293 100644 --- a/internal/api/client/admin/accountreject.go +++ b/internal/api/client/admin/accountreject.go @@ -77,16 +77,28 @@ import ( // schema: // "$ref": "#/definitions/adminAccountInfo" // '400': +// schema: +// "$ref": "#/definitions/error" // description: bad request // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '403': +// schema: +// "$ref": "#/definitions/error" // description: forbidden // '404': +// schema: +// "$ref": "#/definitions/error" // description: not found // '406': +// schema: +// "$ref": "#/definitions/error" // description: not acceptable // '500': +// schema: +// "$ref": "#/definitions/error" // description: internal server error func (m *Module) AccountRejectPOSTHandler(c *gin.Context) { authed, errWithCode := apiutil.TokenAuth(c, diff --git a/internal/api/client/admin/accountsgetv1.go b/internal/api/client/admin/accountsgetv1.go index 3b3b5b783..06074db12 100644 --- a/internal/api/client/admin/accountsgetv1.go +++ b/internal/api/client/admin/accountsgetv1.go @@ -161,16 +161,28 @@ // items: // "$ref": "#/definitions/adminAccountInfo" // '400': +// schema: +// "$ref": "#/definitions/error" // description: bad request // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '403': +// schema: +// "$ref": "#/definitions/error" // description: forbidden // '404': +// schema: +// "$ref": "#/definitions/error" // description: not found // '406': +// schema: +// "$ref": "#/definitions/error" // description: not acceptable // '500': +// schema: +// "$ref": "#/definitions/error" // description: internal server error package admin diff --git a/internal/api/client/admin/accountsgetv2.go b/internal/api/client/admin/accountsgetv2.go index 971ecf9b4..bc26e6cc8 100644 --- a/internal/api/client/admin/accountsgetv2.go +++ b/internal/api/client/admin/accountsgetv2.go @@ -134,16 +134,28 @@ // items: // "$ref": "#/definitions/adminAccountInfo" // '400': +// schema: +// "$ref": "#/definitions/error" // description: bad request // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '403': +// schema: +// "$ref": "#/definitions/error" // description: forbidden // '404': +// schema: +// "$ref": "#/definitions/error" // description: not found // '406': +// schema: +// "$ref": "#/definitions/error" // description: not acceptable // '500': +// schema: +// "$ref": "#/definitions/error" // description: internal server error package admin diff --git a/internal/api/client/admin/debug_off.go b/internal/api/client/admin/debug_off.go index 667cf1be9..e412bfc88 100644 --- a/internal/api/client/admin/debug_off.go +++ b/internal/api/client/admin/debug_off.go @@ -63,14 +63,24 @@ import ( // schema: // "$ref": "#/definitions/debugAPUrlResponse" // '400': +// schema: +// "$ref": "#/definitions/error" // description: bad request // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '404': +// schema: +// "$ref": "#/definitions/error" // description: not found // '406': +// schema: +// "$ref": "#/definitions/error" // description: not acceptable // '500': +// schema: +// "$ref": "#/definitions/error" // description: internal server error func (m *Module) DebugAPUrlHandler(c *gin.Context) {} @@ -95,13 +105,23 @@ func (m *Module) DebugAPUrlHandler(c *gin.Context) {} // '200': // description: All good baby! // '400': +// schema: +// "$ref": "#/definitions/error" // description: bad request // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '404': +// schema: +// "$ref": "#/definitions/error" // description: not found // '406': +// schema: +// "$ref": "#/definitions/error" // description: not acceptable // '500': +// schema: +// "$ref": "#/definitions/error" // description: internal server error func (m *Module) DebugClearCachesHandler(c *gin.Context) {} diff --git a/internal/api/client/admin/domainallowcreate.go b/internal/api/client/admin/domainallowcreate.go index d7ccac620..756ded829 100644 --- a/internal/api/client/admin/domainallowcreate.go +++ b/internal/api/client/admin/domainallowcreate.go @@ -103,21 +103,35 @@ import ( // schema: // "$ref": "#/definitions/domainPermission" // '400': +// schema: +// "$ref": "#/definitions/error" // description: bad request // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '403': +// schema: +// "$ref": "#/definitions/error" // description: forbidden // '404': +// schema: +// "$ref": "#/definitions/error" // description: not found // '406': +// schema: +// "$ref": "#/definitions/error" // description: not acceptable // '409': +// schema: +// "$ref": "#/definitions/error" // description: >- // Conflict: There is already an admin action running that conflicts with this action. // Check the error message in the response body for more information. This is a temporary // error; it should be possible to process this action if you try again in a bit. // '500': +// schema: +// "$ref": "#/definitions/error" // description: internal server error func (m *Module) DomainAllowsPOSTHandler(c *gin.Context) { m.createDomainPermissions(c, diff --git a/internal/api/client/admin/domainallowdelete.go b/internal/api/client/admin/domainallowdelete.go index 06e6ea538..498f7e6d1 100644 --- a/internal/api/client/admin/domainallowdelete.go +++ b/internal/api/client/admin/domainallowdelete.go @@ -51,21 +51,35 @@ import ( // schema: // "$ref": "#/definitions/domainPermission" // '400': +// schema: +// "$ref": "#/definitions/error" // description: bad request // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '403': +// schema: +// "$ref": "#/definitions/error" // description: forbidden // '404': +// schema: +// "$ref": "#/definitions/error" // description: not found // '406': +// schema: +// "$ref": "#/definitions/error" // description: not acceptable // '409': +// schema: +// "$ref": "#/definitions/error" // description: >- // Conflict: There is already an admin action running that conflicts with this action. // Check the error message in the response body for more information. This is a temporary // error; it should be possible to process this action if you try again in a bit. // '500': +// schema: +// "$ref": "#/definitions/error" // description: internal server error func (m *Module) DomainAllowDELETEHandler(c *gin.Context) { m.deleteDomainPermission(c, gtsmodel.DomainPermissionAllow) diff --git a/internal/api/client/admin/domainallowget.go b/internal/api/client/admin/domainallowget.go index 61c6dae20..5214ea825 100644 --- a/internal/api/client/admin/domainallowget.go +++ b/internal/api/client/admin/domainallowget.go @@ -51,16 +51,28 @@ import ( // schema: // "$ref": "#/definitions/domainPermission" // '400': +// schema: +// "$ref": "#/definitions/error" // description: bad request // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '403': +// schema: +// "$ref": "#/definitions/error" // description: forbidden // '404': +// schema: +// "$ref": "#/definitions/error" // description: not found // '406': +// schema: +// "$ref": "#/definitions/error" // description: not acceptable // '500': +// schema: +// "$ref": "#/definitions/error" // description: internal server error func (m *Module) DomainAllowGETHandler(c *gin.Context) { m.getDomainPermission(c, gtsmodel.DomainPermissionAllow) diff --git a/internal/api/client/admin/domainallowsget.go b/internal/api/client/admin/domainallowsget.go index d973b9df4..fc5b56b8d 100644 --- a/internal/api/client/admin/domainallowsget.go +++ b/internal/api/client/admin/domainallowsget.go @@ -57,16 +57,28 @@ import ( // items: // "$ref": "#/definitions/domainPermission" // '400': +// schema: +// "$ref": "#/definitions/error" // description: bad request // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '403': +// schema: +// "$ref": "#/definitions/error" // description: forbidden // '404': +// schema: +// "$ref": "#/definitions/error" // description: not found // '406': +// schema: +// "$ref": "#/definitions/error" // description: not acceptable // '500': +// schema: +// "$ref": "#/definitions/error" // description: internal server error func (m *Module) DomainAllowsGETHandler(c *gin.Context) { m.getDomainPermissions(c, gtsmodel.DomainPermissionAllow) diff --git a/internal/api/client/admin/domainallowupdate.go b/internal/api/client/admin/domainallowupdate.go index 9b28d4682..d3c090bff 100644 --- a/internal/api/client/admin/domainallowupdate.go +++ b/internal/api/client/admin/domainallowupdate.go @@ -75,16 +75,28 @@ import ( // schema: // "$ref": "#/definitions/domainPermission" // '400': +// schema: +// "$ref": "#/definitions/error" // description: bad request // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '403': +// schema: +// "$ref": "#/definitions/error" // description: forbidden // '404': +// schema: +// "$ref": "#/definitions/error" // description: not found // '406': +// schema: +// "$ref": "#/definitions/error" // description: not acceptable // '500': +// schema: +// "$ref": "#/definitions/error" // description: internal server error func (m *Module) DomainAllowUpdatePUTHandler(c *gin.Context) { m.updateDomainPermission(c, gtsmodel.DomainPermissionAllow) diff --git a/internal/api/client/admin/domainblockcreate.go b/internal/api/client/admin/domainblockcreate.go index e305d7e5a..421be70b0 100644 --- a/internal/api/client/admin/domainblockcreate.go +++ b/internal/api/client/admin/domainblockcreate.go @@ -103,21 +103,35 @@ import ( // schema: // "$ref": "#/definitions/domainPermission" // '400': +// schema: +// "$ref": "#/definitions/error" // description: bad request // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '403': +// schema: +// "$ref": "#/definitions/error" // description: forbidden // '404': +// schema: +// "$ref": "#/definitions/error" // description: not found // '406': +// schema: +// "$ref": "#/definitions/error" // description: not acceptable // '409': +// schema: +// "$ref": "#/definitions/error" // description: >- // Conflict: There is already an admin action running that conflicts with this action. // Check the error message in the response body for more information. This is a temporary // error; it should be possible to process this action if you try again in a bit. // '500': +// schema: +// "$ref": "#/definitions/error" // description: internal server error func (m *Module) DomainBlocksPOSTHandler(c *gin.Context) { m.createDomainPermissions(c, diff --git a/internal/api/client/admin/domainblockdelete.go b/internal/api/client/admin/domainblockdelete.go index f7bda40b0..b59f1287a 100644 --- a/internal/api/client/admin/domainblockdelete.go +++ b/internal/api/client/admin/domainblockdelete.go @@ -51,21 +51,35 @@ import ( // schema: // "$ref": "#/definitions/domainPermission" // '400': +// schema: +// "$ref": "#/definitions/error" // description: bad request // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '403': +// schema: +// "$ref": "#/definitions/error" // description: forbidden // '404': +// schema: +// "$ref": "#/definitions/error" // description: not found // '406': +// schema: +// "$ref": "#/definitions/error" // description: not acceptable // '409': +// schema: +// "$ref": "#/definitions/error" // description: >- // Conflict: There is already an admin action running that conflicts with this action. // Check the error message in the response body for more information. This is a temporary // error; it should be possible to process this action if you try again in a bit. // '500': +// schema: +// "$ref": "#/definitions/error" // description: internal server error func (m *Module) DomainBlockDELETEHandler(c *gin.Context) { m.deleteDomainPermission(c, gtsmodel.DomainPermissionBlock) diff --git a/internal/api/client/admin/domainblockget.go b/internal/api/client/admin/domainblockget.go index 23d0795f5..21fd01234 100644 --- a/internal/api/client/admin/domainblockget.go +++ b/internal/api/client/admin/domainblockget.go @@ -51,16 +51,28 @@ import ( // schema: // "$ref": "#/definitions/domainPermission" // '400': +// schema: +// "$ref": "#/definitions/error" // description: bad request // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '403': +// schema: +// "$ref": "#/definitions/error" // description: forbidden // '404': +// schema: +// "$ref": "#/definitions/error" // description: not found // '406': +// schema: +// "$ref": "#/definitions/error" // description: not acceptable // '500': +// schema: +// "$ref": "#/definitions/error" // description: internal server error func (m *Module) DomainBlockGETHandler(c *gin.Context) { m.getDomainPermission(c, gtsmodel.DomainPermissionBlock) diff --git a/internal/api/client/admin/domainblocksget.go b/internal/api/client/admin/domainblocksget.go index 1728fbe3d..561c1d8c0 100644 --- a/internal/api/client/admin/domainblocksget.go +++ b/internal/api/client/admin/domainblocksget.go @@ -57,16 +57,28 @@ import ( // items: // "$ref": "#/definitions/domainPermission" // '400': +// schema: +// "$ref": "#/definitions/error" // description: bad request // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '403': +// schema: +// "$ref": "#/definitions/error" // description: forbidden // '404': +// schema: +// "$ref": "#/definitions/error" // description: not found // '406': +// schema: +// "$ref": "#/definitions/error" // description: not acceptable // '500': +// schema: +// "$ref": "#/definitions/error" // description: internal server error func (m *Module) DomainBlocksGETHandler(c *gin.Context) { m.getDomainPermissions(c, gtsmodel.DomainPermissionBlock) diff --git a/internal/api/client/admin/domainblockupdate.go b/internal/api/client/admin/domainblockupdate.go index b3c4408c8..0ce3fb48b 100644 --- a/internal/api/client/admin/domainblockupdate.go +++ b/internal/api/client/admin/domainblockupdate.go @@ -75,16 +75,28 @@ import ( // schema: // "$ref": "#/definitions/domainPermission" // '400': +// schema: +// "$ref": "#/definitions/error" // description: bad request // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '403': +// schema: +// "$ref": "#/definitions/error" // description: forbidden // '404': +// schema: +// "$ref": "#/definitions/error" // description: not found // '406': +// schema: +// "$ref": "#/definitions/error" // description: not acceptable // '500': +// schema: +// "$ref": "#/definitions/error" // description: internal server error func (m *Module) DomainBlockUpdatePUTHandler(c *gin.Context) { m.updateDomainPermission(c, gtsmodel.DomainPermissionBlock) diff --git a/internal/api/client/admin/domainkeysexpire.go b/internal/api/client/admin/domainkeysexpire.go index e18eae126..6f2e1bb6b 100644 --- a/internal/api/client/admin/domainkeysexpire.go +++ b/internal/api/client/admin/domainkeysexpire.go @@ -77,21 +77,35 @@ import ( // schema: // "$ref": "#/definitions/adminActionResponse" // '400': +// schema: +// "$ref": "#/definitions/error" // description: bad request // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '403': +// schema: +// "$ref": "#/definitions/error" // description: forbidden // '404': +// schema: +// "$ref": "#/definitions/error" // description: not found // '406': +// schema: +// "$ref": "#/definitions/error" // description: not acceptable // '409': +// schema: +// "$ref": "#/definitions/error" // description: >- // Conflict: There is already an admin action running that conflicts with this action. // Check the error message in the response body for more information. This is a temporary // error; it should be possible to process this action if you try again in a bit. // '500': +// schema: +// "$ref": "#/definitions/error" // description: internal server error func (m *Module) DomainKeysExpirePOSTHandler(c *gin.Context) { authed, errWithCode := apiutil.TokenAuth(c, diff --git a/internal/api/client/admin/domainpermissiondraftaccept.go b/internal/api/client/admin/domainpermissiondraftaccept.go index 2514d339c..b501c5bd8 100644 --- a/internal/api/client/admin/domainpermissiondraftaccept.go +++ b/internal/api/client/admin/domainpermissiondraftaccept.go @@ -68,16 +68,28 @@ import ( // schema: // "$ref": "#/definitions/domainPermission" // '400': +// schema: +// "$ref": "#/definitions/error" // description: bad request // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '403': +// schema: +// "$ref": "#/definitions/error" // description: forbidden // '406': +// schema: +// "$ref": "#/definitions/error" // description: not acceptable // '409': +// schema: +// "$ref": "#/definitions/error" // description: conflict // '500': +// schema: +// "$ref": "#/definitions/error" // description: internal server error func (m *Module) DomainPermissionDraftAcceptPOSTHandler(c *gin.Context) { authed, errWithCode := apiutil.TokenAuth(c, true, true, true, true) diff --git a/internal/api/client/admin/domainpermissiondraftcreate.go b/internal/api/client/admin/domainpermissiondraftcreate.go index 71aee0c05..f4932ff5c 100644 --- a/internal/api/client/admin/domainpermissiondraftcreate.go +++ b/internal/api/client/admin/domainpermissiondraftcreate.go @@ -87,16 +87,28 @@ import ( // schema: // "$ref": "#/definitions/domainPermission" // '400': +// schema: +// "$ref": "#/definitions/error" // description: bad request // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '403': +// schema: +// "$ref": "#/definitions/error" // description: forbidden // '406': +// schema: +// "$ref": "#/definitions/error" // description: not acceptable // '409': +// schema: +// "$ref": "#/definitions/error" // description: conflict // '500': +// schema: +// "$ref": "#/definitions/error" // description: internal server error func (m *Module) DomainPermissionDraftsPOSTHandler(c *gin.Context) { authed, errWithCode := apiutil.TokenAuth(c, diff --git a/internal/api/client/admin/domainpermissiondraftget.go b/internal/api/client/admin/domainpermissiondraftget.go index 8f4aa03bf..0f9cfee6b 100644 --- a/internal/api/client/admin/domainpermissiondraftget.go +++ b/internal/api/client/admin/domainpermissiondraftget.go @@ -55,14 +55,24 @@ import ( // schema: // "$ref": "#/definitions/domainPermission" // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '403': +// schema: +// "$ref": "#/definitions/error" // description: forbidden // '404': +// schema: +// "$ref": "#/definitions/error" // description: not found // '406': +// schema: +// "$ref": "#/definitions/error" // description: not acceptable // '500': +// schema: +// "$ref": "#/definitions/error" // description: internal server error func (m *Module) DomainPermissionDraftGETHandler(c *gin.Context) { authed, errWithCode := apiutil.TokenAuth(c, diff --git a/internal/api/client/admin/domainpermissiondraftremove.go b/internal/api/client/admin/domainpermissiondraftremove.go index 6cd476b19..180e63ea9 100644 --- a/internal/api/client/admin/domainpermissiondraftremove.go +++ b/internal/api/client/admin/domainpermissiondraftremove.go @@ -68,16 +68,28 @@ import ( // schema: // "$ref": "#/definitions/domainPermission" // '400': +// schema: +// "$ref": "#/definitions/error" // description: bad request // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '403': +// schema: +// "$ref": "#/definitions/error" // description: forbidden // '406': +// schema: +// "$ref": "#/definitions/error" // description: not acceptable // '409': +// schema: +// "$ref": "#/definitions/error" // description: conflict // '500': +// schema: +// "$ref": "#/definitions/error" // description: internal server error func (m *Module) DomainPermissionDraftRemovePOSTHandler(c *gin.Context) { authed, errWithCode := apiutil.TokenAuth(c, diff --git a/internal/api/client/admin/domainpermissiondraftsget.go b/internal/api/client/admin/domainpermissiondraftsget.go index b54332202..68ac7c962 100644 --- a/internal/api/client/admin/domainpermissiondraftsget.go +++ b/internal/api/client/admin/domainpermissiondraftsget.go @@ -112,16 +112,28 @@ import ( // type: string // description: Links to the next and previous queries. // '400': +// schema: +// "$ref": "#/definitions/error" // description: bad request // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '403': +// schema: +// "$ref": "#/definitions/error" // description: forbidden // '404': +// schema: +// "$ref": "#/definitions/error" // description: not found // '406': +// schema: +// "$ref": "#/definitions/error" // description: not acceptable // '500': +// schema: +// "$ref": "#/definitions/error" // description: internal server error func (m *Module) DomainPermissionDraftsGETHandler(c *gin.Context) { authed, errWithCode := apiutil.TokenAuth(c, diff --git a/internal/api/client/admin/domainpermissionexcludecreate.go b/internal/api/client/admin/domainpermissionexcludecreate.go index 1b8dd307b..2f7f07e79 100644 --- a/internal/api/client/admin/domainpermissionexcludecreate.go +++ b/internal/api/client/admin/domainpermissionexcludecreate.go @@ -69,16 +69,28 @@ import ( // schema: // "$ref": "#/definitions/domainPermission" // '400': +// schema: +// "$ref": "#/definitions/error" // description: bad request // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '403': +// schema: +// "$ref": "#/definitions/error" // description: forbidden // '406': +// schema: +// "$ref": "#/definitions/error" // description: not acceptable // '409': +// schema: +// "$ref": "#/definitions/error" // description: conflict // '500': +// schema: +// "$ref": "#/definitions/error" // description: internal server error func (m *Module) DomainPermissionExcludesPOSTHandler(c *gin.Context) { authed, errWithCode := apiutil.TokenAuth(c, diff --git a/internal/api/client/admin/domainpermissionexcludeget.go b/internal/api/client/admin/domainpermissionexcludeget.go index 18d3ea56e..3484cc2c5 100644 --- a/internal/api/client/admin/domainpermissionexcludeget.go +++ b/internal/api/client/admin/domainpermissionexcludeget.go @@ -55,14 +55,24 @@ import ( // schema: // "$ref": "#/definitions/domainPermission" // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '403': +// schema: +// "$ref": "#/definitions/error" // description: forbidden // '404': +// schema: +// "$ref": "#/definitions/error" // description: not found // '406': +// schema: +// "$ref": "#/definitions/error" // description: not acceptable // '500': +// schema: +// "$ref": "#/definitions/error" // description: internal server error func (m *Module) DomainPermissionExcludeGETHandler(c *gin.Context) { authed, errWithCode := apiutil.TokenAuth(c, diff --git a/internal/api/client/admin/domainpermissionexcluderemove.go b/internal/api/client/admin/domainpermissionexcluderemove.go index c1dc98241..426dbdc2b 100644 --- a/internal/api/client/admin/domainpermissionexcluderemove.go +++ b/internal/api/client/admin/domainpermissionexcluderemove.go @@ -55,16 +55,28 @@ import ( // schema: // "$ref": "#/definitions/domainPermission" // '400': +// schema: +// "$ref": "#/definitions/error" // description: bad request // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '403': +// schema: +// "$ref": "#/definitions/error" // description: forbidden // '406': +// schema: +// "$ref": "#/definitions/error" // description: not acceptable // '409': +// schema: +// "$ref": "#/definitions/error" // description: conflict // '500': +// schema: +// "$ref": "#/definitions/error" // description: internal server error func (m *Module) DomainPermissionExcludeDELETEHandler(c *gin.Context) { authed, errWithCode := apiutil.TokenAuth(c, diff --git a/internal/api/client/admin/domainpermissionexcludesget.go b/internal/api/client/admin/domainpermissionexcludesget.go index d245c1666..71cfbb300 100644 --- a/internal/api/client/admin/domainpermissionexcludesget.go +++ b/internal/api/client/admin/domainpermissionexcludesget.go @@ -100,16 +100,28 @@ import ( // type: string // description: Links to the next and previous queries. // '400': +// schema: +// "$ref": "#/definitions/error" // description: bad request // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '403': +// schema: +// "$ref": "#/definitions/error" // description: forbidden // '404': +// schema: +// "$ref": "#/definitions/error" // description: not found // '406': +// schema: +// "$ref": "#/definitions/error" // description: not acceptable // '500': +// schema: +// "$ref": "#/definitions/error" // description: internal server error func (m *Module) DomainPermissionExcludesGETHandler(c *gin.Context) { authed, errWithCode := apiutil.TokenAuth(c, diff --git a/internal/api/client/admin/domainpermissionsubscriptioncreate.go b/internal/api/client/admin/domainpermissionsubscriptioncreate.go index e57b4bc3f..231feb4fa 100644 --- a/internal/api/client/admin/domainpermissionsubscriptioncreate.go +++ b/internal/api/client/admin/domainpermissionsubscriptioncreate.go @@ -141,16 +141,28 @@ import ( // schema: // "$ref": "#/definitions/domainPermissionSubscription" // '400': +// schema: +// "$ref": "#/definitions/error" // description: bad request // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '403': +// schema: +// "$ref": "#/definitions/error" // description: forbidden // '406': +// schema: +// "$ref": "#/definitions/error" // description: not acceptable // '409': +// schema: +// "$ref": "#/definitions/error" // description: conflict // '500': +// schema: +// "$ref": "#/definitions/error" // description: internal server error func (m *Module) DomainPermissionSubscriptionPOSTHandler(c *gin.Context) { authed, errWithCode := apiutil.TokenAuth(c, diff --git a/internal/api/client/admin/domainpermissionsubscriptionget.go b/internal/api/client/admin/domainpermissionsubscriptionget.go index 43bb90623..007718b45 100644 --- a/internal/api/client/admin/domainpermissionsubscriptionget.go +++ b/internal/api/client/admin/domainpermissionsubscriptionget.go @@ -55,14 +55,24 @@ import ( // schema: // "$ref": "#/definitions/domainPermissionSubscription" // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '403': +// schema: +// "$ref": "#/definitions/error" // description: forbidden // '404': +// schema: +// "$ref": "#/definitions/error" // description: not found // '406': +// schema: +// "$ref": "#/definitions/error" // description: not acceptable // '500': +// schema: +// "$ref": "#/definitions/error" // description: internal server error func (m *Module) DomainPermissionSubscriptionGETHandler(c *gin.Context) { authed, errWithCode := apiutil.TokenAuth(c, diff --git a/internal/api/client/admin/domainpermissionsubscriptionremove.go b/internal/api/client/admin/domainpermissionsubscriptionremove.go index f44241d1e..286e8e475 100644 --- a/internal/api/client/admin/domainpermissionsubscriptionremove.go +++ b/internal/api/client/admin/domainpermissionsubscriptionremove.go @@ -75,16 +75,28 @@ import ( // schema: // "$ref": "#/definitions/domainPermissionSubscription" // '400': +// schema: +// "$ref": "#/definitions/error" // description: bad request // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '403': +// schema: +// "$ref": "#/definitions/error" // description: forbidden // '406': +// schema: +// "$ref": "#/definitions/error" // description: not acceptable // '409': +// schema: +// "$ref": "#/definitions/error" // description: conflict // '500': +// schema: +// "$ref": "#/definitions/error" // description: internal server error func (m *Module) DomainPermissionSubscriptionRemovePOSTHandler(c *gin.Context) { authed, errWithCode := apiutil.TokenAuth(c, diff --git a/internal/api/client/admin/domainpermissionsubscriptionsget.go b/internal/api/client/admin/domainpermissionsubscriptionsget.go index 55f1a8de0..90d0d8d3c 100644 --- a/internal/api/client/admin/domainpermissionsubscriptionsget.go +++ b/internal/api/client/admin/domainpermissionsubscriptionsget.go @@ -102,16 +102,28 @@ import ( // type: string // description: Links to the next and previous queries. // '400': +// schema: +// "$ref": "#/definitions/error" // description: bad request // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '403': +// schema: +// "$ref": "#/definitions/error" // description: forbidden // '404': +// schema: +// "$ref": "#/definitions/error" // description: not found // '406': +// schema: +// "$ref": "#/definitions/error" // description: not acceptable // '500': +// schema: +// "$ref": "#/definitions/error" // description: internal server error func (m *Module) DomainPermissionSubscriptionsGETHandler(c *gin.Context) { authed, errWithCode := apiutil.TokenAuth(c, diff --git a/internal/api/client/admin/domainpermissionsubscriptionspreviewget.go b/internal/api/client/admin/domainpermissionsubscriptionspreviewget.go index 193a2ca24..d424b5853 100644 --- a/internal/api/client/admin/domainpermissionsubscriptionspreviewget.go +++ b/internal/api/client/admin/domainpermissionsubscriptionspreviewget.go @@ -61,16 +61,28 @@ import ( // items: // "$ref": "#/definitions/domainPermissionSubscription" // '400': +// schema: +// "$ref": "#/definitions/error" // description: bad request // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '403': +// schema: +// "$ref": "#/definitions/error" // description: forbidden // '404': +// schema: +// "$ref": "#/definitions/error" // description: not found // '406': +// schema: +// "$ref": "#/definitions/error" // description: not acceptable // '500': +// schema: +// "$ref": "#/definitions/error" // description: internal server error func (m *Module) DomainPermissionSubscriptionsPreviewGETHandler(c *gin.Context) { authed, errWithCode := apiutil.TokenAuth(c, diff --git a/internal/api/client/admin/domainpermissionsubscriptiontest.go b/internal/api/client/admin/domainpermissionsubscriptiontest.go index cb27312c6..30b0d591d 100644 --- a/internal/api/client/admin/domainpermissionsubscriptiontest.go +++ b/internal/api/client/admin/domainpermissionsubscriptiontest.go @@ -63,16 +63,28 @@ import ( // items: // "$ref": "#/definitions/domain" // '400': +// schema: +// "$ref": "#/definitions/error" // description: bad request // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '403': +// schema: +// "$ref": "#/definitions/error" // description: forbidden // '406': +// schema: +// "$ref": "#/definitions/error" // description: not acceptable // '409': +// schema: +// "$ref": "#/definitions/error" // description: conflict // '500': +// schema: +// "$ref": "#/definitions/error" // description: internal server error func (m *Module) DomainPermissionSubscriptionTestPOSTHandler(c *gin.Context) { authed, errWithCode := apiutil.TokenAuth(c, diff --git a/internal/api/client/admin/domainpermissionsubscriptionupdate.go b/internal/api/client/admin/domainpermissionsubscriptionupdate.go index 416f8ec10..752ab244a 100644 --- a/internal/api/client/admin/domainpermissionsubscriptionupdate.go +++ b/internal/api/client/admin/domainpermissionsubscriptionupdate.go @@ -137,16 +137,28 @@ import ( // schema: // "$ref": "#/definitions/domainPermissionSubscription" // '400': +// schema: +// "$ref": "#/definitions/error" // description: bad request // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '403': +// schema: +// "$ref": "#/definitions/error" // description: forbidden // '406': +// schema: +// "$ref": "#/definitions/error" // description: not acceptable // '409': +// schema: +// "$ref": "#/definitions/error" // description: conflict // '500': +// schema: +// "$ref": "#/definitions/error" // description: internal server error func (m *Module) DomainPermissionSubscriptionPATCHHandler(c *gin.Context) { authed, errWithCode := apiutil.TokenAuth(c, diff --git a/internal/api/client/admin/emailtest.go b/internal/api/client/admin/emailtest.go index bd5d12dc6..b50c75a29 100644 --- a/internal/api/client/admin/emailtest.go +++ b/internal/api/client/admin/emailtest.go @@ -68,22 +68,36 @@ import ( // '202': // description: Test email was sent. // '400': +// schema: +// "$ref": "#/definitions/error" // description: bad request // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '403': +// schema: +// "$ref": "#/definitions/error" // description: forbidden // '404': +// schema: +// "$ref": "#/definitions/error" // description: not found // '406': +// schema: +// "$ref": "#/definitions/error" // description: not acceptable // '422': +// schema: +// "$ref": "#/definitions/error" // description: >- // An smtp occurred while the email attempt was in progress. // Check the returned json for more information. The smtp error // will be included, to help you debug communication with the // smtp server. // '500': +// schema: +// "$ref": "#/definitions/error" // description: internal server error func (m *Module) EmailTestPOSTHandler(c *gin.Context) { authed, errWithCode := apiutil.TokenAuth(c, diff --git a/internal/api/client/admin/emojicategoriesget.go b/internal/api/client/admin/emojicategoriesget.go index c2a8cbabb..dd00ceec6 100644 --- a/internal/api/client/admin/emojicategoriesget.go +++ b/internal/api/client/admin/emojicategoriesget.go @@ -49,16 +49,28 @@ import ( // items: // "$ref": "#/definitions/emojiCategory" // '400': +// schema: +// "$ref": "#/definitions/error" // description: bad request // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '403': +// schema: +// "$ref": "#/definitions/error" // description: forbidden // '404': +// schema: +// "$ref": "#/definitions/error" // description: not found // '406': +// schema: +// "$ref": "#/definitions/error" // description: not acceptable // '500': +// schema: +// "$ref": "#/definitions/error" // description: internal server error func (m *Module) EmojiCategoriesGETHandler(c *gin.Context) { authed, errWithCode := apiutil.TokenAuth(c, diff --git a/internal/api/client/admin/emojicreate.go b/internal/api/client/admin/emojicreate.go index 04f0602c0..558292a33 100644 --- a/internal/api/client/admin/emojicreate.go +++ b/internal/api/client/admin/emojicreate.go @@ -83,18 +83,32 @@ import ( // schema: // "$ref": "#/definitions/emoji" // '400': +// schema: +// "$ref": "#/definitions/error" // description: bad request // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '403': +// schema: +// "$ref": "#/definitions/error" // description: forbidden // '404': +// schema: +// "$ref": "#/definitions/error" // description: not found // '406': +// schema: +// "$ref": "#/definitions/error" // description: not acceptable // '409': +// schema: +// "$ref": "#/definitions/error" // description: conflict -- shortcode for this emoji is already in use // '500': +// schema: +// "$ref": "#/definitions/error" // description: internal server error func (m *Module) EmojiCreatePOSTHandler(c *gin.Context) { authed, errWithCode := apiutil.TokenAuth(c, diff --git a/internal/api/client/admin/emojidelete.go b/internal/api/client/admin/emojidelete.go index 83c49a92a..49b16d02b 100644 --- a/internal/api/client/admin/emojidelete.go +++ b/internal/api/client/admin/emojidelete.go @@ -61,16 +61,28 @@ import ( // schema: // "$ref": "#/definitions/adminEmoji" // '400': +// schema: +// "$ref": "#/definitions/error" // description: bad request // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '403': +// schema: +// "$ref": "#/definitions/error" // description: forbidden // '404': +// schema: +// "$ref": "#/definitions/error" // description: not found // '406': +// schema: +// "$ref": "#/definitions/error" // description: not acceptable // '500': +// schema: +// "$ref": "#/definitions/error" // description: internal server error func (m *Module) EmojiDELETEHandler(c *gin.Context) { authed, errWithCode := apiutil.TokenAuth(c, diff --git a/internal/api/client/admin/emojiget.go b/internal/api/client/admin/emojiget.go index 1ae7eb9e9..73c1adb1b 100644 --- a/internal/api/client/admin/emojiget.go +++ b/internal/api/client/admin/emojiget.go @@ -55,16 +55,28 @@ import ( // schema: // "$ref": "#/definitions/adminEmoji" // '400': +// schema: +// "$ref": "#/definitions/error" // description: bad request // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '403': +// schema: +// "$ref": "#/definitions/error" // description: forbidden // '404': +// schema: +// "$ref": "#/definitions/error" // description: not found // '406': +// schema: +// "$ref": "#/definitions/error" // description: not acceptable // '500': +// schema: +// "$ref": "#/definitions/error" // description: internal server error func (m *Module) EmojiGETHandler(c *gin.Context) { authed, errWithCode := apiutil.TokenAuth(c, diff --git a/internal/api/client/admin/emojisget.go b/internal/api/client/admin/emojisget.go index 4dbbd7f53..945452203 100644 --- a/internal/api/client/admin/emojisget.go +++ b/internal/api/client/admin/emojisget.go @@ -114,16 +114,28 @@ import ( // items: // "$ref": "#/definitions/adminEmoji" // '400': +// schema: +// "$ref": "#/definitions/error" // description: bad request // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '403': +// schema: +// "$ref": "#/definitions/error" // description: forbidden // '404': +// schema: +// "$ref": "#/definitions/error" // description: not found // '406': +// schema: +// "$ref": "#/definitions/error" // description: not acceptable // '500': +// schema: +// "$ref": "#/definitions/error" // description: internal server error func (m *Module) EmojisGETHandler(c *gin.Context) { authed, errWithCode := apiutil.TokenAuth(c, diff --git a/internal/api/client/admin/emojiupdate.go b/internal/api/client/admin/emojiupdate.go index d1576a15d..cab07eee0 100644 --- a/internal/api/client/admin/emojiupdate.go +++ b/internal/api/client/admin/emojiupdate.go @@ -112,16 +112,28 @@ import ( // schema: // "$ref": "#/definitions/adminEmoji" // '400': +// schema: +// "$ref": "#/definitions/error" // description: bad request // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '403': +// schema: +// "$ref": "#/definitions/error" // description: forbidden // '404': +// schema: +// "$ref": "#/definitions/error" // description: not found // '406': +// schema: +// "$ref": "#/definitions/error" // description: not acceptable // '500': +// schema: +// "$ref": "#/definitions/error" // description: internal server error func (m *Module) EmojiPATCHHandler(c *gin.Context) { authed, errWithCode := apiutil.TokenAuth(c, diff --git a/internal/api/client/admin/headerfilter_create.go b/internal/api/client/admin/headerfilter_create.go index a5b5e5309..683984262 100644 --- a/internal/api/client/admin/headerfilter_create.go +++ b/internal/api/client/admin/headerfilter_create.go @@ -50,12 +50,20 @@ import ( // schema: // "$ref": "#/definitions/headerFilter" // '400': +// schema: +// "$ref": "#/definitions/error" // description: bad request // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '403': +// schema: +// "$ref": "#/definitions/error" // description: forbidden // '500': +// schema: +// "$ref": "#/definitions/error" // description: internal server error func (m *Module) HeaderFilterAllowPOST(c *gin.Context) { m.createHeaderFilter(c, m.processor.Admin().CreateAllowHeaderFilter) @@ -90,12 +98,20 @@ func (m *Module) HeaderFilterAllowPOST(c *gin.Context) { // schema: // "$ref": "#/definitions/headerFilter" // '400': +// schema: +// "$ref": "#/definitions/error" // description: bad request // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '403': +// schema: +// "$ref": "#/definitions/error" // description: forbidden // '500': +// schema: +// "$ref": "#/definitions/error" // description: internal server error func (m *Module) HeaderFilterBlockPOST(c *gin.Context) { m.createHeaderFilter(c, m.processor.Admin().CreateBlockHeaderFilter) diff --git a/internal/api/client/admin/headerfilter_delete.go b/internal/api/client/admin/headerfilter_delete.go index 400c5c4e3..7f2731f1c 100644 --- a/internal/api/client/admin/headerfilter_delete.go +++ b/internal/api/client/admin/headerfilter_delete.go @@ -45,14 +45,24 @@ import ( // '202': // description: Accepted // '400': +// schema: +// "$ref": "#/definitions/error" // description: bad request // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '403': +// schema: +// "$ref": "#/definitions/error" // description: forbidden // '404': +// schema: +// "$ref": "#/definitions/error" // description: not found // '500': +// schema: +// "$ref": "#/definitions/error" // description: internal server error func (m *Module) HeaderFilterAllowDELETE(c *gin.Context) { m.deleteHeaderFilter(c, m.processor.Admin().DeleteAllowHeaderFilter) @@ -82,14 +92,24 @@ func (m *Module) HeaderFilterAllowDELETE(c *gin.Context) { // '202': // description: Accepted // '400': +// schema: +// "$ref": "#/definitions/error" // description: bad request // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '403': +// schema: +// "$ref": "#/definitions/error" // description: forbidden // '404': +// schema: +// "$ref": "#/definitions/error" // description: not found // '500': +// schema: +// "$ref": "#/definitions/error" // description: internal server error func (m *Module) HeaderFilterBlockDELETE(c *gin.Context) { m.deleteHeaderFilter(c, m.processor.Admin().DeleteBlockHeaderFilter) diff --git a/internal/api/client/admin/headerfilter_get.go b/internal/api/client/admin/headerfilter_get.go index cd00fe24c..a475c2700 100644 --- a/internal/api/client/admin/headerfilter_get.go +++ b/internal/api/client/admin/headerfilter_get.go @@ -45,14 +45,24 @@ import "github.com/gin-gonic/gin" // schema: // "$ref": "#/definitions/headerFilter" // '400': +// schema: +// "$ref": "#/definitions/error" // description: bad request // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '403': +// schema: +// "$ref": "#/definitions/error" // description: forbidden // '404': +// schema: +// "$ref": "#/definitions/error" // description: not found // '500': +// schema: +// "$ref": "#/definitions/error" // description: internal server error func (m *Module) HeaderFilterAllowGET(c *gin.Context) { m.getHeaderFilter(c, m.processor.Admin().GetAllowHeaderFilter) @@ -84,14 +94,24 @@ func (m *Module) HeaderFilterAllowGET(c *gin.Context) { // schema: // "$ref": "#/definitions/headerFilter" // '400': +// schema: +// "$ref": "#/definitions/error" // description: bad request // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '403': +// schema: +// "$ref": "#/definitions/error" // description: forbidden // '404': +// schema: +// "$ref": "#/definitions/error" // description: not found // '500': +// schema: +// "$ref": "#/definitions/error" // description: internal server error func (m *Module) HeaderFilterBlockGET(c *gin.Context) { m.getHeaderFilter(c, m.processor.Admin().GetBlockHeaderFilter) @@ -117,14 +137,24 @@ func (m *Module) HeaderFilterBlockGET(c *gin.Context) { // items: // "$ref": "#/definitions/headerFilter" // '400': +// schema: +// "$ref": "#/definitions/error" // description: bad request // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '403': +// schema: +// "$ref": "#/definitions/error" // description: forbidden // '404': +// schema: +// "$ref": "#/definitions/error" // description: not found // '500': +// schema: +// "$ref": "#/definitions/error" // description: internal server error func (m *Module) HeaderFilterAllowsGET(c *gin.Context) { m.getHeaderFilters(c, m.processor.Admin().GetAllowHeaderFilters) @@ -150,14 +180,24 @@ func (m *Module) HeaderFilterAllowsGET(c *gin.Context) { // items: // "$ref": "#/definitions/headerFilter" // '400': +// schema: +// "$ref": "#/definitions/error" // description: bad request // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '403': +// schema: +// "$ref": "#/definitions/error" // description: forbidden // '404': +// schema: +// "$ref": "#/definitions/error" // description: not found // '500': +// schema: +// "$ref": "#/definitions/error" // description: internal server error func (m *Module) HeaderFilterBlocksGET(c *gin.Context) { m.getHeaderFilters(c, m.processor.Admin().GetBlockHeaderFilters) diff --git a/internal/api/client/admin/mediacleanup.go b/internal/api/client/admin/mediacleanup.go index 56610ce3e..455f252fe 100644 --- a/internal/api/client/admin/mediacleanup.go +++ b/internal/api/client/admin/mediacleanup.go @@ -56,16 +56,28 @@ import ( // Echos the number of days requested. // The cleanup is performed asynchronously after the request completes. // '400': +// schema: +// "$ref": "#/definitions/error" // description: bad request // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '403': +// schema: +// "$ref": "#/definitions/error" // description: forbidden // '404': +// schema: +// "$ref": "#/definitions/error" // description: not found // '406': +// schema: +// "$ref": "#/definitions/error" // description: not acceptable // '500': +// schema: +// "$ref": "#/definitions/error" // description: internal server error func (m *Module) MediaCleanupPOSTHandler(c *gin.Context) { authed, errWithCode := apiutil.TokenAuth(c, diff --git a/internal/api/client/admin/mediarefetch.go b/internal/api/client/admin/mediarefetch.go index bf32ad207..0bf69ac01 100644 --- a/internal/api/client/admin/mediarefetch.go +++ b/internal/api/client/admin/mediarefetch.go @@ -58,16 +58,28 @@ import ( // Request accepted and will be processed. // Check the logs for progress / errors. // '400': +// schema: +// "$ref": "#/definitions/error" // description: bad request // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '403': +// schema: +// "$ref": "#/definitions/error" // description: forbidden // '404': +// schema: +// "$ref": "#/definitions/error" // description: not found // '406': +// schema: +// "$ref": "#/definitions/error" // description: not acceptable // '500': +// schema: +// "$ref": "#/definitions/error" // description: internal server error func (m *Module) MediaRefetchPOSTHandler(c *gin.Context) { authed, errWithCode := apiutil.TokenAuth(c, diff --git a/internal/api/client/admin/reportget.go b/internal/api/client/admin/reportget.go index 6f870303a..d92f9e5cb 100644 --- a/internal/api/client/admin/reportget.go +++ b/internal/api/client/admin/reportget.go @@ -56,14 +56,24 @@ import ( // schema: // "$ref": "#/definitions/adminReport" // '400': +// schema: +// "$ref": "#/definitions/error" // description: bad request // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '404': +// schema: +// "$ref": "#/definitions/error" // description: not found // '406': +// schema: +// "$ref": "#/definitions/error" // description: not acceptable // '500': +// schema: +// "$ref": "#/definitions/error" // description: internal server error func (m *Module) ReportGETHandler(c *gin.Context) { authed, errWithCode := apiutil.TokenAuth(c, diff --git a/internal/api/client/admin/reportresolve.go b/internal/api/client/admin/reportresolve.go index df9e749a6..3b589968c 100644 --- a/internal/api/client/admin/reportresolve.go +++ b/internal/api/client/admin/reportresolve.go @@ -73,14 +73,24 @@ import ( // schema: // "$ref": "#/definitions/adminReport" // '400': +// schema: +// "$ref": "#/definitions/error" // description: bad request // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '404': +// schema: +// "$ref": "#/definitions/error" // description: not found // '406': +// schema: +// "$ref": "#/definitions/error" // description: not acceptable // '500': +// schema: +// "$ref": "#/definitions/error" // description: internal server error func (m *Module) ReportResolvePOSTHandler(c *gin.Context) { authed, errWithCode := apiutil.TokenAuth(c, diff --git a/internal/api/client/admin/reportsget.go b/internal/api/client/admin/reportsget.go index 31c93cbcc..10a31beb0 100644 --- a/internal/api/client/admin/reportsget.go +++ b/internal/api/client/admin/reportsget.go @@ -114,14 +114,24 @@ import ( // type: string // description: Links to the next and previous queries. // '400': +// schema: +// "$ref": "#/definitions/error" // description: bad request // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '404': +// schema: +// "$ref": "#/definitions/error" // description: not found // '406': +// schema: +// "$ref": "#/definitions/error" // description: not acceptable // '500': +// schema: +// "$ref": "#/definitions/error" // description: internal server error func (m *Module) ReportsGETHandler(c *gin.Context) { authed, errWithCode := apiutil.TokenAuth(c, diff --git a/internal/api/client/admin/rulecreate.go b/internal/api/client/admin/rulecreate.go index ac8febaed..4a4a439c1 100644 --- a/internal/api/client/admin/rulecreate.go +++ b/internal/api/client/admin/rulecreate.go @@ -52,16 +52,28 @@ import ( // schema: // "$ref": "#/definitions/instanceRule" // '400': +// schema: +// "$ref": "#/definitions/error" // description: bad request // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '403': +// schema: +// "$ref": "#/definitions/error" // description: forbidden // '404': +// schema: +// "$ref": "#/definitions/error" // description: not found // '406': +// schema: +// "$ref": "#/definitions/error" // description: not acceptable // '500': +// schema: +// "$ref": "#/definitions/error" // description: internal server error func (m *Module) RulePOSTHandler(c *gin.Context) { authed, errWithCode := apiutil.TokenAuth(c, diff --git a/internal/api/client/admin/ruledelete.go b/internal/api/client/admin/ruledelete.go index b6415cf3b..38c67ddb4 100644 --- a/internal/api/client/admin/ruledelete.go +++ b/internal/api/client/admin/ruledelete.go @@ -59,16 +59,28 @@ import ( // schema: // "$ref": "#/definitions/instanceRule" // '400': +// schema: +// "$ref": "#/definitions/error" // description: bad request // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '403': +// schema: +// "$ref": "#/definitions/error" // description: forbidden // '404': +// schema: +// "$ref": "#/definitions/error" // description: not found // '406': +// schema: +// "$ref": "#/definitions/error" // description: not acceptable // '500': +// schema: +// "$ref": "#/definitions/error" // description: internal server error func (m *Module) RuleDELETEHandler(c *gin.Context) { authed, errWithCode := apiutil.TokenAuth(c, diff --git a/internal/api/client/admin/ruleget.go b/internal/api/client/admin/ruleget.go index ce21bbb26..af6288716 100644 --- a/internal/api/client/admin/ruleget.go +++ b/internal/api/client/admin/ruleget.go @@ -56,14 +56,24 @@ import ( // schema: // "$ref": "#/definitions/instanceRule" // '400': +// schema: +// "$ref": "#/definitions/error" // description: bad request // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '404': +// schema: +// "$ref": "#/definitions/error" // description: not found // '406': +// schema: +// "$ref": "#/definitions/error" // description: not acceptable // '500': +// schema: +// "$ref": "#/definitions/error" // description: internal server error func (m *Module) RuleGETHandler(c *gin.Context) { authed, errWithCode := apiutil.TokenAuth(c, diff --git a/internal/api/client/admin/rulesget.go b/internal/api/client/admin/rulesget.go index 48cd4b43c..4191dc93d 100644 --- a/internal/api/client/admin/rulesget.go +++ b/internal/api/client/admin/rulesget.go @@ -53,14 +53,24 @@ import ( // items: // "$ref": "#/definitions/instanceRule" // '400': +// schema: +// "$ref": "#/definitions/error" // description: bad request // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '404': +// schema: +// "$ref": "#/definitions/error" // description: not found // '406': +// schema: +// "$ref": "#/definitions/error" // description: not acceptable // '500': +// schema: +// "$ref": "#/definitions/error" // description: internal server error func (m *Module) RulesGETHandler(c *gin.Context) { authed, errWithCode := apiutil.TokenAuth(c, diff --git a/internal/api/client/admin/ruleupdate.go b/internal/api/client/admin/ruleupdate.go index 8f2efe845..2b44e76b8 100644 --- a/internal/api/client/admin/ruleupdate.go +++ b/internal/api/client/admin/ruleupdate.go @@ -51,16 +51,28 @@ import ( // schema: // "$ref": "#/definitions/instanceRule" // '400': +// schema: +// "$ref": "#/definitions/error" // description: bad request // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '403': +// schema: +// "$ref": "#/definitions/error" // description: forbidden // '404': +// schema: +// "$ref": "#/definitions/error" // description: not found // '406': +// schema: +// "$ref": "#/definitions/error" // description: not acceptable // '500': +// schema: +// "$ref": "#/definitions/error" // description: internal server error func (m *Module) RulePATCHHandler(c *gin.Context) { authed, errWithCode := apiutil.TokenAuth(c, diff --git a/internal/api/client/announcements/announcementsget.go b/internal/api/client/announcements/announcementsget.go index 90347c177..8d5e7bb09 100644 --- a/internal/api/client/announcements/announcementsget.go +++ b/internal/api/client/announcements/announcementsget.go @@ -49,12 +49,20 @@ import ( // type: object // maxItems: 0 // '400': +// schema: +// "$ref": "#/definitions/error" // description: bad request // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '406': +// schema: +// "$ref": "#/definitions/error" // description: not acceptable // '500': +// schema: +// "$ref": "#/definitions/error" // description: internal server error func (m *Module) AnnouncementsGETHandler(c *gin.Context) { _, errWithCode := apiutil.TokenAuth(c, diff --git a/internal/api/client/apps/appcreate.go b/internal/api/client/apps/appcreate.go index 11784bf63..29ffd41b4 100644 --- a/internal/api/client/apps/appcreate.go +++ b/internal/api/client/apps/appcreate.go @@ -66,16 +66,28 @@ const ( // schema: // "$ref": "#/definitions/application" // '400': +// schema: +// "$ref": "#/definitions/error" // description: bad request // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '403': +// schema: +// "$ref": "#/definitions/error" // description: forbidden // '404': +// schema: +// "$ref": "#/definitions/error" // description: not found // '406': +// schema: +// "$ref": "#/definitions/error" // description: not acceptable // '500': +// schema: +// "$ref": "#/definitions/error" // description: internal server error func (m *Module) AppsPOSTHandler(c *gin.Context) { authed, errWithCode := apiutil.TokenAuth(c, diff --git a/internal/api/client/apps/appdelete.go b/internal/api/client/apps/appdelete.go index db3b31d5c..3ca12a649 100644 --- a/internal/api/client/apps/appdelete.go +++ b/internal/api/client/apps/appdelete.go @@ -54,14 +54,24 @@ import ( // schema: // "$ref": "#/definitions/application" // '400': +// schema: +// "$ref": "#/definitions/error" // description: bad request // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '404': +// schema: +// "$ref": "#/definitions/error" // description: not found // '406': +// schema: +// "$ref": "#/definitions/error" // description: not acceptable // '500': +// schema: +// "$ref": "#/definitions/error" // description: internal server error func (m *Module) AppDELETEHandler(c *gin.Context) { authed, errWithCode := apiutil.TokenAuth(c, diff --git a/internal/api/client/apps/appget.go b/internal/api/client/apps/appget.go index fc16c5ae1..016cfdc73 100644 --- a/internal/api/client/apps/appget.go +++ b/internal/api/client/apps/appget.go @@ -54,14 +54,24 @@ import ( // schema: // "$ref": "#/definitions/application" // '400': +// schema: +// "$ref": "#/definitions/error" // description: bad request // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '404': +// schema: +// "$ref": "#/definitions/error" // description: not found // '406': +// schema: +// "$ref": "#/definitions/error" // description: not acceptable // '500': +// schema: +// "$ref": "#/definitions/error" // description: internal server error func (m *Module) AppGETHandler(c *gin.Context) { authed, errWithCode := apiutil.TokenAuth(c, diff --git a/internal/api/client/apps/appsget.go b/internal/api/client/apps/appsget.go index 31b2e9337..299c42aa4 100644 --- a/internal/api/client/apps/appsget.go +++ b/internal/api/client/apps/appsget.go @@ -94,14 +94,24 @@ import ( // items: // "$ref": "#/definitions/application" // '400': +// schema: +// "$ref": "#/definitions/error" // description: bad request // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '404': +// schema: +// "$ref": "#/definitions/error" // description: not found // '406': +// schema: +// "$ref": "#/definitions/error" // description: not acceptable // '500': +// schema: +// "$ref": "#/definitions/error" // description: internal server error func (m *Module) AppsGETHandler(c *gin.Context) { authed, errWithCode := apiutil.TokenAuth(c, diff --git a/internal/api/client/blocks/blocksget.go b/internal/api/client/blocks/blocksget.go index 45a24cf91..11ce5d07f 100644 --- a/internal/api/client/blocks/blocksget.go +++ b/internal/api/client/blocks/blocksget.go @@ -96,14 +96,24 @@ import ( // items: // "$ref": "#/definitions/account" // '400': +// schema: +// "$ref": "#/definitions/error" // description: bad request // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '404': +// schema: +// "$ref": "#/definitions/error" // description: not found // '406': +// schema: +// "$ref": "#/definitions/error" // description: not acceptable // '500': +// schema: +// "$ref": "#/definitions/error" // description: internal server error func (m *Module) BlocksGETHandler(c *gin.Context) { authed, errWithCode := apiutil.TokenAuth(c, diff --git a/internal/api/client/bookmarks/bookmarksget.go b/internal/api/client/bookmarks/bookmarksget.go index beaec63f3..a8fe9d7a4 100644 --- a/internal/api/client/bookmarks/bookmarksget.go +++ b/internal/api/client/bookmarks/bookmarksget.go @@ -86,10 +86,16 @@ const ( // type: string // description: Links to the next and previous queries. // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '406': +// schema: +// "$ref": "#/definitions/error" // description: not acceptable // '500': +// schema: +// "$ref": "#/definitions/error" // description: internal server error func (m *Module) BookmarksGETHandler(c *gin.Context) { authed, errWithCode := apiutil.TokenAuth(c, diff --git a/internal/api/client/conversations/conversationdelete.go b/internal/api/client/conversations/conversationdelete.go index 6757ffe1a..8449b3a3c 100644 --- a/internal/api/client/conversations/conversationdelete.go +++ b/internal/api/client/conversations/conversationdelete.go @@ -55,14 +55,24 @@ import ( // '200': // description: conversation deleted // '400': +// schema: +// "$ref": "#/definitions/error" // description: bad request // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '404': +// schema: +// "$ref": "#/definitions/error" // description: not found // '406': +// schema: +// "$ref": "#/definitions/error" // description: not acceptable // '500': +// schema: +// "$ref": "#/definitions/error" // description: internal server error func (m *Module) ConversationDELETEHandler(c *gin.Context) { authed, errWithCode := apiutil.TokenAuth(c, diff --git a/internal/api/client/conversations/conversationread.go b/internal/api/client/conversations/conversationread.go index 0eb907ca4..3bfb31b0a 100644 --- a/internal/api/client/conversations/conversationread.go +++ b/internal/api/client/conversations/conversationread.go @@ -55,16 +55,28 @@ import ( // schema: // "$ref": "#/definitions/conversation" // '400': +// schema: +// "$ref": "#/definitions/error" // description: bad request // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '404': +// schema: +// "$ref": "#/definitions/error" // description: not found // '406': +// schema: +// "$ref": "#/definitions/error" // description: not acceptable // '422': +// schema: +// "$ref": "#/definitions/error" // description: unprocessable content // '500': +// schema: +// "$ref": "#/definitions/error" // description: internal server error func (m *Module) ConversationReadPOSTHandler(c *gin.Context) { authed, errWithCode := apiutil.TokenAuth(c, diff --git a/internal/api/client/conversations/conversationsget.go b/internal/api/client/conversations/conversationsget.go index c9edd0825..dcaff3ec9 100644 --- a/internal/api/client/conversations/conversationsget.go +++ b/internal/api/client/conversations/conversationsget.go @@ -96,14 +96,24 @@ import ( // items: // "$ref": "#/definitions/conversation" // '400': +// schema: +// "$ref": "#/definitions/error" // description: bad request // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '404': +// schema: +// "$ref": "#/definitions/error" // description: not found // '406': +// schema: +// "$ref": "#/definitions/error" // description: not acceptable // '500': +// schema: +// "$ref": "#/definitions/error" // description: internal server error func (m *Module) ConversationsGETHandler(c *gin.Context) { authed, errWithCode := apiutil.TokenAuth(c, diff --git a/internal/api/client/customemojis/customemojisget.go b/internal/api/client/customemojis/customemojisget.go index 9aa878274..384b6bbae 100644 --- a/internal/api/client/customemojis/customemojisget.go +++ b/internal/api/client/customemojis/customemojisget.go @@ -51,10 +51,16 @@ import ( // items: // "$ref": "#/definitions/emoji" // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '406': +// schema: +// "$ref": "#/definitions/error" // description: not acceptable // '500': +// schema: +// "$ref": "#/definitions/error" // description: internal server error func (m *Module) CustomEmojisGETHandler(c *gin.Context) { // If custom emojis are not exposed to unauthed diff --git a/internal/api/client/exports/blocks.go b/internal/api/client/exports/blocks.go index fae8a201b..614073971 100644 --- a/internal/api/client/exports/blocks.go +++ b/internal/api/client/exports/blocks.go @@ -45,10 +45,16 @@ import ( // name: accounts // description: CSV file of accounts that you block. // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '406': +// schema: +// "$ref": "#/definitions/error" // description: not acceptable // '500': +// schema: +// "$ref": "#/definitions/error" // description: internal server error func (m *Module) ExportBlocksGETHandler(c *gin.Context) { authed, errWithCode := apiutil.TokenAuth(c, diff --git a/internal/api/client/exports/followers.go b/internal/api/client/exports/followers.go index 520fbef70..7a5ce075d 100644 --- a/internal/api/client/exports/followers.go +++ b/internal/api/client/exports/followers.go @@ -45,10 +45,16 @@ import ( // name: accounts // description: CSV file of accounts that follow you. // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '406': +// schema: +// "$ref": "#/definitions/error" // description: not acceptable // '500': +// schema: +// "$ref": "#/definitions/error" // description: internal server error func (m *Module) ExportFollowersGETHandler(c *gin.Context) { authed, errWithCode := apiutil.TokenAuth(c, diff --git a/internal/api/client/exports/following.go b/internal/api/client/exports/following.go index 8d6306092..e7fb908fb 100644 --- a/internal/api/client/exports/following.go +++ b/internal/api/client/exports/following.go @@ -45,10 +45,16 @@ import ( // name: accounts // description: CSV file of accounts that you follow. // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '406': +// schema: +// "$ref": "#/definitions/error" // description: not acceptable // '500': +// schema: +// "$ref": "#/definitions/error" // description: internal server error func (m *Module) ExportFollowingGETHandler(c *gin.Context) { authed, errWithCode := apiutil.TokenAuth(c, diff --git a/internal/api/client/exports/lists.go b/internal/api/client/exports/lists.go index cf152bf55..ccd4b9012 100644 --- a/internal/api/client/exports/lists.go +++ b/internal/api/client/exports/lists.go @@ -45,10 +45,16 @@ import ( // name: accounts // description: CSV file of lists. // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '406': +// schema: +// "$ref": "#/definitions/error" // description: not acceptable // '500': +// schema: +// "$ref": "#/definitions/error" // description: internal server error func (m *Module) ExportListsGETHandler(c *gin.Context) { authed, errWithCode := apiutil.TokenAuth(c, diff --git a/internal/api/client/exports/mutes.go b/internal/api/client/exports/mutes.go index 0db94db62..66550950e 100644 --- a/internal/api/client/exports/mutes.go +++ b/internal/api/client/exports/mutes.go @@ -45,10 +45,16 @@ import ( // name: accounts // description: CSV file of accounts that you mute. // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '406': +// schema: +// "$ref": "#/definitions/error" // description: not acceptable // '500': +// schema: +// "$ref": "#/definitions/error" // description: internal server error func (m *Module) ExportMutesGETHandler(c *gin.Context) { authed, errWithCode := apiutil.TokenAuth(c, diff --git a/internal/api/client/exports/stats.go b/internal/api/client/exports/stats.go index 6b9436065..3eccfb644 100644 --- a/internal/api/client/exports/stats.go +++ b/internal/api/client/exports/stats.go @@ -46,10 +46,16 @@ import ( // schema: // "$ref": "#/definitions/accountExportStats" // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '406': +// schema: +// "$ref": "#/definitions/error" // description: not acceptable // '500': +// schema: +// "$ref": "#/definitions/error" // description: internal server error func (m *Module) ExportStatsGETHandler(c *gin.Context) { authed, errWithCode := apiutil.TokenAuth(c, diff --git a/internal/api/client/favourites/favouritesget.go b/internal/api/client/favourites/favouritesget.go index 8b1f646c4..97112f708 100644 --- a/internal/api/client/favourites/favouritesget.go +++ b/internal/api/client/favourites/favouritesget.go @@ -82,14 +82,24 @@ import ( // items: // "$ref": "#/definitions/status" // '400': +// schema: +// "$ref": "#/definitions/error" // description: bad request // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '404': +// schema: +// "$ref": "#/definitions/error" // description: not found // '406': +// schema: +// "$ref": "#/definitions/error" // description: not acceptable // '500': +// schema: +// "$ref": "#/definitions/error" // description: internal server error func (m *Module) FavouritesGETHandler(c *gin.Context) { authed, errWithCode := apiutil.TokenAuth(c, diff --git a/internal/api/client/featuredtags/get.go b/internal/api/client/featuredtags/get.go index 7b5c68e40..b570c8dcb 100644 --- a/internal/api/client/featuredtags/get.go +++ b/internal/api/client/featuredtags/get.go @@ -49,14 +49,24 @@ import ( // items: // type: object // '400': +// schema: +// "$ref": "#/definitions/error" // description: bad request // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '404': +// schema: +// "$ref": "#/definitions/error" // description: not found // '406': +// schema: +// "$ref": "#/definitions/error" // description: not acceptable // '500': +// schema: +// "$ref": "#/definitions/error" // description: internal server error func (m *Module) FeaturedTagsGETHandler(c *gin.Context) { _, errWithCode := apiutil.TokenAuth(c, diff --git a/internal/api/client/filters/v1/filterdelete.go b/internal/api/client/filters/v1/filterdelete.go index 5283240c5..4e171bbaf 100644 --- a/internal/api/client/filters/v1/filterdelete.go +++ b/internal/api/client/filters/v1/filterdelete.go @@ -52,14 +52,24 @@ import ( // '200': // description: filter deleted // '400': +// schema: +// "$ref": "#/definitions/error" // description: bad request // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '404': +// schema: +// "$ref": "#/definitions/error" // description: not found // '406': +// schema: +// "$ref": "#/definitions/error" // description: not acceptable // '500': +// schema: +// "$ref": "#/definitions/error" // description: internal server error func (m *Module) FilterDELETEHandler(c *gin.Context) { authed, errWithCode := apiutil.TokenAuth(c, diff --git a/internal/api/client/filters/v1/filterget.go b/internal/api/client/filters/v1/filterget.go index 704be540a..ffe2a300b 100644 --- a/internal/api/client/filters/v1/filterget.go +++ b/internal/api/client/filters/v1/filterget.go @@ -55,14 +55,24 @@ import ( // schema: // "$ref": "#/definitions/filterV1" // '400': +// schema: +// "$ref": "#/definitions/error" // description: bad request // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '404': +// schema: +// "$ref": "#/definitions/error" // description: not found // '406': +// schema: +// "$ref": "#/definitions/error" // description: not acceptable // '500': +// schema: +// "$ref": "#/definitions/error" // description: internal server error func (m *Module) FilterGETHandler(c *gin.Context) { authed, errWithCode := apiutil.TokenAuth(c, diff --git a/internal/api/client/filters/v1/filterpost.go b/internal/api/client/filters/v1/filterpost.go index d61ddbdb8..5840fea44 100644 --- a/internal/api/client/filters/v1/filterpost.go +++ b/internal/api/client/filters/v1/filterpost.go @@ -113,20 +113,36 @@ import ( // schema: // "$ref": "#/definitions/filterV1" // '400': +// schema: +// "$ref": "#/definitions/error" // description: bad request // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '403': +// schema: +// "$ref": "#/definitions/error" // description: forbidden to moved accounts // '404': +// schema: +// "$ref": "#/definitions/error" // description: not found // '406': +// schema: +// "$ref": "#/definitions/error" // description: not acceptable // '409': +// schema: +// "$ref": "#/definitions/error" // description: conflict (duplicate keyword) // '422': +// schema: +// "$ref": "#/definitions/error" // description: unprocessable content // '500': +// schema: +// "$ref": "#/definitions/error" // description: internal server error func (m *Module) FilterPOSTHandler(c *gin.Context) { authed, errWithCode := apiutil.TokenAuth(c, diff --git a/internal/api/client/filters/v1/filterput.go b/internal/api/client/filters/v1/filterput.go index ab08f0d92..64c1711fe 100644 --- a/internal/api/client/filters/v1/filterput.go +++ b/internal/api/client/filters/v1/filterput.go @@ -119,20 +119,36 @@ import ( // schema: // "$ref": "#/definitions/filterV1" // '400': +// schema: +// "$ref": "#/definitions/error" // description: bad request // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '403': +// schema: +// "$ref": "#/definitions/error" // description: forbidden to moved accounts // '404': +// schema: +// "$ref": "#/definitions/error" // description: not found // '406': +// schema: +// "$ref": "#/definitions/error" // description: not acceptable // '409': +// schema: +// "$ref": "#/definitions/error" // description: conflict (duplicate keyword) // '422': +// schema: +// "$ref": "#/definitions/error" // description: unprocessable content // '500': +// schema: +// "$ref": "#/definitions/error" // description: internal server error func (m *Module) FilterPUTHandler(c *gin.Context) { authed, errWithCode := apiutil.TokenAuth(c, diff --git a/internal/api/client/filters/v1/filtersget.go b/internal/api/client/filters/v1/filtersget.go index 42a7c3b7e..c5ba0e9cd 100644 --- a/internal/api/client/filters/v1/filtersget.go +++ b/internal/api/client/filters/v1/filtersget.go @@ -49,14 +49,24 @@ import ( // items: // "$ref": "#/definitions/filterV1" // '400': +// schema: +// "$ref": "#/definitions/error" // description: bad request // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '404': +// schema: +// "$ref": "#/definitions/error" // description: not found // '406': +// schema: +// "$ref": "#/definitions/error" // description: not acceptable // '500': +// schema: +// "$ref": "#/definitions/error" // description: internal server error func (m *Module) FiltersGETHandler(c *gin.Context) { authed, errWithCode := apiutil.TokenAuth(c, diff --git a/internal/api/client/filters/v2/filterdelete.go b/internal/api/client/filters/v2/filterdelete.go index 4ede393de..3631f2983 100644 --- a/internal/api/client/filters/v2/filterdelete.go +++ b/internal/api/client/filters/v2/filterdelete.go @@ -52,14 +52,24 @@ import ( // '200': // description: filter deleted // '400': +// schema: +// "$ref": "#/definitions/error" // description: bad request // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '404': +// schema: +// "$ref": "#/definitions/error" // description: not found // '406': +// schema: +// "$ref": "#/definitions/error" // description: not acceptable // '500': +// schema: +// "$ref": "#/definitions/error" // description: internal server error func (m *Module) FilterDELETEHandler(c *gin.Context) { authed, errWithCode := apiutil.TokenAuth(c, diff --git a/internal/api/client/filters/v2/filterget.go b/internal/api/client/filters/v2/filterget.go index 21ac6a2ca..df01000cf 100644 --- a/internal/api/client/filters/v2/filterget.go +++ b/internal/api/client/filters/v2/filterget.go @@ -55,14 +55,24 @@ import ( // schema: // "$ref": "#/definitions/filterV2" // '400': +// schema: +// "$ref": "#/definitions/error" // description: bad request // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '404': +// schema: +// "$ref": "#/definitions/error" // description: not found // '406': +// schema: +// "$ref": "#/definitions/error" // description: not acceptable // '500': +// schema: +// "$ref": "#/definitions/error" // description: internal server error func (m *Module) FilterGETHandler(c *gin.Context) { authed, errWithCode := apiutil.TokenAuth(c, diff --git a/internal/api/client/filters/v2/filterkeyworddelete.go b/internal/api/client/filters/v2/filterkeyworddelete.go index 63c235d16..4ad936907 100644 --- a/internal/api/client/filters/v2/filterkeyworddelete.go +++ b/internal/api/client/filters/v2/filterkeyworddelete.go @@ -52,14 +52,24 @@ import ( // '200': // description: filter keyword deleted // '400': +// schema: +// "$ref": "#/definitions/error" // description: bad request // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '404': +// schema: +// "$ref": "#/definitions/error" // description: not found // '406': +// schema: +// "$ref": "#/definitions/error" // description: not acceptable // '500': +// schema: +// "$ref": "#/definitions/error" // description: internal server error func (m *Module) FilterKeywordDELETEHandler(c *gin.Context) { authed, errWithCode := apiutil.TokenAuth(c, diff --git a/internal/api/client/filters/v2/filterkeywordget.go b/internal/api/client/filters/v2/filterkeywordget.go index e8e4dec0c..af3d12466 100644 --- a/internal/api/client/filters/v2/filterkeywordget.go +++ b/internal/api/client/filters/v2/filterkeywordget.go @@ -55,14 +55,24 @@ import ( // schema: // "$ref": "#/definitions/filterKeyword" // '400': +// schema: +// "$ref": "#/definitions/error" // description: bad request // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '404': +// schema: +// "$ref": "#/definitions/error" // description: not found // '406': +// schema: +// "$ref": "#/definitions/error" // description: not acceptable // '500': +// schema: +// "$ref": "#/definitions/error" // description: internal server error func (m *Module) FilterKeywordGETHandler(c *gin.Context) { authed, errWithCode := apiutil.TokenAuth(c, diff --git a/internal/api/client/filters/v2/filterkeywordpost.go b/internal/api/client/filters/v2/filterkeywordpost.go index 1068f78f8..f3eb31502 100644 --- a/internal/api/client/filters/v2/filterkeywordpost.go +++ b/internal/api/client/filters/v2/filterkeywordpost.go @@ -83,20 +83,36 @@ import ( // schema: // "$ref": "#/definitions/filterKeyword" // '400': +// schema: +// "$ref": "#/definitions/error" // description: bad request // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '403': +// schema: +// "$ref": "#/definitions/error" // description: forbidden to moved accounts // '404': +// schema: +// "$ref": "#/definitions/error" // description: not found // '406': +// schema: +// "$ref": "#/definitions/error" // description: not acceptable // '409': +// schema: +// "$ref": "#/definitions/error" // description: conflict (duplicate keyword) // '422': +// schema: +// "$ref": "#/definitions/error" // description: unprocessable content // '500': +// schema: +// "$ref": "#/definitions/error" // description: internal server error func (m *Module) FilterKeywordPOSTHandler(c *gin.Context) { authed, errWithCode := apiutil.TokenAuth(c, diff --git a/internal/api/client/filters/v2/filterkeywordput.go b/internal/api/client/filters/v2/filterkeywordput.go index dae3a0042..75c904fc7 100644 --- a/internal/api/client/filters/v2/filterkeywordput.go +++ b/internal/api/client/filters/v2/filterkeywordput.go @@ -80,20 +80,36 @@ import ( // schema: // "$ref": "#/definitions/filterKeyword" // '400': +// schema: +// "$ref": "#/definitions/error" // description: bad request // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '403': +// schema: +// "$ref": "#/definitions/error" // description: forbidden to moved accounts // '404': +// schema: +// "$ref": "#/definitions/error" // description: not found // '406': +// schema: +// "$ref": "#/definitions/error" // description: not acceptable // '409': +// schema: +// "$ref": "#/definitions/error" // description: conflict (duplicate keyword) // '422': +// schema: +// "$ref": "#/definitions/error" // description: unprocessable content // '500': +// schema: +// "$ref": "#/definitions/error" // description: internal server error func (m *Module) FilterKeywordPUTHandler(c *gin.Context) { authed, errWithCode := apiutil.TokenAuth(c, diff --git a/internal/api/client/filters/v2/filterkeywordsget.go b/internal/api/client/filters/v2/filterkeywordsget.go index 3bfe81bc6..c2e6ecef2 100644 --- a/internal/api/client/filters/v2/filterkeywordsget.go +++ b/internal/api/client/filters/v2/filterkeywordsget.go @@ -57,14 +57,24 @@ import ( // items: // "$ref": "#/definitions/filterKeyword" // '400': +// schema: +// "$ref": "#/definitions/error" // description: bad request // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '404': +// schema: +// "$ref": "#/definitions/error" // description: not found // '406': +// schema: +// "$ref": "#/definitions/error" // description: not acceptable // '500': +// schema: +// "$ref": "#/definitions/error" // description: internal server error func (m *Module) FilterKeywordsGETHandler(c *gin.Context) { authed, errWithCode := apiutil.TokenAuth(c, diff --git a/internal/api/client/filters/v2/filterpost.go b/internal/api/client/filters/v2/filterpost.go index c2473557a..7cb11da92 100644 --- a/internal/api/client/filters/v2/filterpost.go +++ b/internal/api/client/filters/v2/filterpost.go @@ -133,20 +133,36 @@ import ( // schema: // "$ref": "#/definitions/filterV2" // '400': +// schema: +// "$ref": "#/definitions/error" // description: bad request // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '403': +// schema: +// "$ref": "#/definitions/error" // description: forbidden to moved accounts // '404': +// schema: +// "$ref": "#/definitions/error" // description: not found // '406': +// schema: +// "$ref": "#/definitions/error" // description: not acceptable // '409': +// schema: +// "$ref": "#/definitions/error" // description: conflict (duplicate title, keyword, or status) // '422': +// schema: +// "$ref": "#/definitions/error" // description: unprocessable content // '500': +// schema: +// "$ref": "#/definitions/error" // description: internal server error func (m *Module) FilterPOSTHandler(c *gin.Context) { authed, errWithCode := apiutil.TokenAuth(c, diff --git a/internal/api/client/filters/v2/filterput.go b/internal/api/client/filters/v2/filterput.go index 689c47e5b..4538fa3bf 100644 --- a/internal/api/client/filters/v2/filterput.go +++ b/internal/api/client/filters/v2/filterput.go @@ -141,20 +141,36 @@ import ( // schema: // "$ref": "#/definitions/filterV2" // '400': +// schema: +// "$ref": "#/definitions/error" // description: bad request // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '403': +// schema: +// "$ref": "#/definitions/error" // description: forbidden to moved accounts // '404': +// schema: +// "$ref": "#/definitions/error" // description: not found // '406': +// schema: +// "$ref": "#/definitions/error" // description: not acceptable // '409': +// schema: +// "$ref": "#/definitions/error" // description: conflict (duplicate title, keyword, or status) // '422': +// schema: +// "$ref": "#/definitions/error" // description: unprocessable content // '500': +// schema: +// "$ref": "#/definitions/error" // description: internal server error func (m *Module) FilterPUTHandler(c *gin.Context) { authed, errWithCode := apiutil.TokenAuth(c, diff --git a/internal/api/client/filters/v2/filtersget.go b/internal/api/client/filters/v2/filtersget.go index 94e1db03b..d6d0856ee 100644 --- a/internal/api/client/filters/v2/filtersget.go +++ b/internal/api/client/filters/v2/filtersget.go @@ -49,14 +49,24 @@ import ( // items: // "$ref": "#/definitions/filterV2" // '400': +// schema: +// "$ref": "#/definitions/error" // description: bad request // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '404': +// schema: +// "$ref": "#/definitions/error" // description: not found // '406': +// schema: +// "$ref": "#/definitions/error" // description: not acceptable // '500': +// schema: +// "$ref": "#/definitions/error" // description: internal server error func (m *Module) FiltersGETHandler(c *gin.Context) { authed, errWithCode := apiutil.TokenAuth(c, diff --git a/internal/api/client/filters/v2/filterstatusdelete.go b/internal/api/client/filters/v2/filterstatusdelete.go index 8522fde06..e4a818e49 100644 --- a/internal/api/client/filters/v2/filterstatusdelete.go +++ b/internal/api/client/filters/v2/filterstatusdelete.go @@ -52,14 +52,24 @@ import ( // '200': // description: filter status deleted // '400': +// schema: +// "$ref": "#/definitions/error" // description: bad request // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '404': +// schema: +// "$ref": "#/definitions/error" // description: not found // '406': +// schema: +// "$ref": "#/definitions/error" // description: not acceptable // '500': +// schema: +// "$ref": "#/definitions/error" // description: internal server error func (m *Module) FilterStatusDELETEHandler(c *gin.Context) { authed, errWithCode := apiutil.TokenAuth(c, diff --git a/internal/api/client/filters/v2/filterstatusesget.go b/internal/api/client/filters/v2/filterstatusesget.go index 31616bd36..91ec7f46f 100644 --- a/internal/api/client/filters/v2/filterstatusesget.go +++ b/internal/api/client/filters/v2/filterstatusesget.go @@ -57,14 +57,24 @@ import ( // items: // "$ref": "#/definitions/filterStatus" // '400': +// schema: +// "$ref": "#/definitions/error" // description: bad request // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '404': +// schema: +// "$ref": "#/definitions/error" // description: not found // '406': +// schema: +// "$ref": "#/definitions/error" // description: not acceptable // '500': +// schema: +// "$ref": "#/definitions/error" // description: internal server error func (m *Module) FilterStatusesGETHandler(c *gin.Context) { authed, errWithCode := apiutil.TokenAuth(c, diff --git a/internal/api/client/filters/v2/filterstatusget.go b/internal/api/client/filters/v2/filterstatusget.go index 3add79c26..53410d4e9 100644 --- a/internal/api/client/filters/v2/filterstatusget.go +++ b/internal/api/client/filters/v2/filterstatusget.go @@ -55,14 +55,24 @@ import ( // schema: // "$ref": "#/definitions/filterStatus" // '400': +// schema: +// "$ref": "#/definitions/error" // description: bad request // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '404': +// schema: +// "$ref": "#/definitions/error" // description: not found // '406': +// schema: +// "$ref": "#/definitions/error" // description: not acceptable // '500': +// schema: +// "$ref": "#/definitions/error" // description: internal server error func (m *Module) FilterStatusGETHandler(c *gin.Context) { authed, errWithCode := apiutil.TokenAuth(c, diff --git a/internal/api/client/filters/v2/filterstatuspost.go b/internal/api/client/filters/v2/filterstatuspost.go index b7b6019ac..22ea8b075 100644 --- a/internal/api/client/filters/v2/filterstatuspost.go +++ b/internal/api/client/filters/v2/filterstatuspost.go @@ -71,20 +71,36 @@ import ( // schema: // "$ref": "#/definitions/filterStatus" // '400': +// schema: +// "$ref": "#/definitions/error" // description: bad request // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '403': +// schema: +// "$ref": "#/definitions/error" // description: forbidden to moved accounts // '404': +// schema: +// "$ref": "#/definitions/error" // description: not found // '406': +// schema: +// "$ref": "#/definitions/error" // description: not acceptable // '409': +// schema: +// "$ref": "#/definitions/error" // description: conflict (duplicate status) // '422': +// schema: +// "$ref": "#/definitions/error" // description: unprocessable content // '500': +// schema: +// "$ref": "#/definitions/error" // description: internal server error func (m *Module) FilterStatusPOSTHandler(c *gin.Context) { authed, errWithCode := apiutil.TokenAuth(c, diff --git a/internal/api/client/followedtags/get.go b/internal/api/client/followedtags/get.go index 5cd7e91fb..5b9fa82be 100644 --- a/internal/api/client/followedtags/get.go +++ b/internal/api/client/followedtags/get.go @@ -89,14 +89,24 @@ import ( // items: // "$ref": "#/definitions/tag" // '400': +// schema: +// "$ref": "#/definitions/error" // description: bad request // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '404': +// schema: +// "$ref": "#/definitions/error" // description: not found // '406': +// schema: +// "$ref": "#/definitions/error" // description: not acceptable // '500': +// schema: +// "$ref": "#/definitions/error" // description: internal server error func (m *Module) FollowedTagsGETHandler(c *gin.Context) { authed, errWithCode := apiutil.TokenAuth(c, diff --git a/internal/api/client/followrequests/authorize.go b/internal/api/client/followrequests/authorize.go index bcaad9be6..3fb6d6186 100644 --- a/internal/api/client/followrequests/authorize.go +++ b/internal/api/client/followrequests/authorize.go @@ -58,14 +58,24 @@ import ( // schema: // "$ref": "#/definitions/accountRelationship" // '400': +// schema: +// "$ref": "#/definitions/error" // description: bad request // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '404': +// schema: +// "$ref": "#/definitions/error" // description: not found // '406': +// schema: +// "$ref": "#/definitions/error" // description: not acceptable // '500': +// schema: +// "$ref": "#/definitions/error" // description: internal server error func (m *Module) FollowRequestAuthorizePOSTHandler(c *gin.Context) { authed, errWithCode := apiutil.TokenAuth(c, diff --git a/internal/api/client/followrequests/get.go b/internal/api/client/followrequests/get.go index a55ea3ab2..95ecae837 100644 --- a/internal/api/client/followrequests/get.go +++ b/internal/api/client/followrequests/get.go @@ -97,14 +97,24 @@ import ( // items: // "$ref": "#/definitions/account" // '400': +// schema: +// "$ref": "#/definitions/error" // description: bad request // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '404': +// schema: +// "$ref": "#/definitions/error" // description: not found // '406': +// schema: +// "$ref": "#/definitions/error" // description: not acceptable // '500': +// schema: +// "$ref": "#/definitions/error" // description: internal server error func (m *Module) FollowRequestGETHandler(c *gin.Context) { authed, errWithCode := apiutil.TokenAuth(c, diff --git a/internal/api/client/followrequests/getoutgoing.go b/internal/api/client/followrequests/getoutgoing.go index 4da6dfad8..37043e3b9 100644 --- a/internal/api/client/followrequests/getoutgoing.go +++ b/internal/api/client/followrequests/getoutgoing.go @@ -97,14 +97,24 @@ import ( // items: // "$ref": "#/definitions/account" // '400': +// schema: +// "$ref": "#/definitions/error" // description: bad request // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '404': +// schema: +// "$ref": "#/definitions/error" // description: not found // '406': +// schema: +// "$ref": "#/definitions/error" // description: not acceptable // '500': +// schema: +// "$ref": "#/definitions/error" // description: internal server error func (m *Module) OutgoingFollowRequestGETHandler(c *gin.Context) { authed, errWithCode := apiutil.TokenAuth(c, diff --git a/internal/api/client/followrequests/reject.go b/internal/api/client/followrequests/reject.go index d60a1af08..072e5cd6b 100644 --- a/internal/api/client/followrequests/reject.go +++ b/internal/api/client/followrequests/reject.go @@ -56,14 +56,24 @@ import ( // schema: // "$ref": "#/definitions/accountRelationship" // '400': +// schema: +// "$ref": "#/definitions/error" // description: bad request // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '404': +// schema: +// "$ref": "#/definitions/error" // description: not found // '406': +// schema: +// "$ref": "#/definitions/error" // description: not acceptable // '500': +// schema: +// "$ref": "#/definitions/error" // description: internal server error func (m *Module) FollowRequestRejectPOSTHandler(c *gin.Context) { authed, errWithCode := apiutil.TokenAuth(c, diff --git a/internal/api/client/import/import.go b/internal/api/client/import/import.go index ebd4f64ad..ffdb49566 100644 --- a/internal/api/client/import/import.go +++ b/internal/api/client/import/import.go @@ -118,12 +118,20 @@ func (m *Module) Route(attachHandler func(method string, path string, f ...gin.H // '202': // description: Upload accepted. // '400': +// schema: +// "$ref": "#/definitions/error" // description: bad request // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '406': +// schema: +// "$ref": "#/definitions/error" // description: not acceptable // '500': +// schema: +// "$ref": "#/definitions/error" // description: internal server error func (m *Module) ImportPOSTHandler(c *gin.Context) { authed, errWithCode := apiutil.TokenAuth(c, diff --git a/internal/api/client/instance/domainperms.go b/internal/api/client/instance/domainperms.go index 6503388a5..1076c4d4a 100644 --- a/internal/api/client/instance/domainperms.go +++ b/internal/api/client/instance/domainperms.go @@ -51,16 +51,28 @@ import ( // items: // "$ref": "#/definitions/domain" // '400': +// schema: +// "$ref": "#/definitions/error" // description: bad request // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '403': +// schema: +// "$ref": "#/definitions/error" // description: forbidden // '404': +// schema: +// "$ref": "#/definitions/error" // description: not found // '406': +// schema: +// "$ref": "#/definitions/error" // description: not acceptable // '500': +// schema: +// "$ref": "#/definitions/error" // description: internal server error func (m *Module) InstanceDomainBlocksGETHandler(c *gin.Context) { authed, errWithCode := apiutil.TokenAuth(c, @@ -123,16 +135,28 @@ func (m *Module) InstanceDomainBlocksGETHandler(c *gin.Context) { // items: // "$ref": "#/definitions/domain" // '400': +// schema: +// "$ref": "#/definitions/error" // description: bad request // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '403': +// schema: +// "$ref": "#/definitions/error" // description: forbidden // '404': +// schema: +// "$ref": "#/definitions/error" // description: not found // '406': +// schema: +// "$ref": "#/definitions/error" // description: not acceptable // '500': +// schema: +// "$ref": "#/definitions/error" // description: internal server error func (m *Module) InstanceDomainAllowsGETHandler(c *gin.Context) { authed, errWithCode := apiutil.TokenAuth(c, diff --git a/internal/api/client/instance/instanceget.go b/internal/api/client/instance/instanceget.go index 4740fe1e8..38138cae2 100644 --- a/internal/api/client/instance/instanceget.go +++ b/internal/api/client/instance/instanceget.go @@ -45,8 +45,12 @@ import ( // schema: // "$ref": "#/definitions/instanceV1" // '406': +// schema: +// "$ref": "#/definitions/error" // description: not acceptable // '500': +// schema: +// "$ref": "#/definitions/error" // description: internal error func (m *Module) InstanceInformationGETHandlerV1(c *gin.Context) { if _, err := apiutil.NegotiateAccept(c, apiutil.JSONAcceptHeaders...); err != nil { @@ -97,8 +101,12 @@ func (m *Module) InstanceInformationGETHandlerV1(c *gin.Context) { // schema: // "$ref": "#/definitions/instanceV2" // '406': +// schema: +// "$ref": "#/definitions/error" // description: not acceptable // '500': +// schema: +// "$ref": "#/definitions/error" // description: internal error func (m *Module) InstanceInformationGETHandlerV2(c *gin.Context) { if _, err := apiutil.NegotiateAccept(c, apiutil.JSONAcceptHeaders...); err != nil { diff --git a/internal/api/client/instance/instancepatch.go b/internal/api/client/instance/instancepatch.go index b81f14298..ced5c624d 100644 --- a/internal/api/client/instance/instancepatch.go +++ b/internal/api/client/instance/instancepatch.go @@ -114,16 +114,28 @@ import ( // schema: // "$ref": "#/definitions/instanceV1" // '400': +// schema: +// "$ref": "#/definitions/error" // description: bad request // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '403': +// schema: +// "$ref": "#/definitions/error" // description: forbidden // '404': +// schema: +// "$ref": "#/definitions/error" // description: not found // '406': +// schema: +// "$ref": "#/definitions/error" // description: not acceptable // '500': +// schema: +// "$ref": "#/definitions/error" // description: internal server error func (m *Module) InstanceUpdatePATCHHandler(c *gin.Context) { authed, errWithCode := apiutil.TokenAuth(c, diff --git a/internal/api/client/instance/instancepeersget.go b/internal/api/client/instance/instancepeersget.go index d9f7610b7..e5870eff7 100644 --- a/internal/api/client/instance/instancepeersget.go +++ b/internal/api/client/instance/instancepeersget.go @@ -103,16 +103,28 @@ import ( // items: // "$ref": "#/definitions/domain" // '400': +// schema: +// "$ref": "#/definitions/error" // description: bad request // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '403': +// schema: +// "$ref": "#/definitions/error" // description: forbidden // '404': +// schema: +// "$ref": "#/definitions/error" // description: not found // '406': +// schema: +// "$ref": "#/definitions/error" // description: not acceptable // '500': +// schema: +// "$ref": "#/definitions/error" // description: internal server error func (m *Module) InstancePeersGETHandler(c *gin.Context) { authed, errWithCode := apiutil.TokenAuth(c, diff --git a/internal/api/client/instance/instancerulesget.go b/internal/api/client/instance/instancerulesget.go index 8daedec74..814ff0439 100644 --- a/internal/api/client/instance/instancerulesget.go +++ b/internal/api/client/instance/instancerulesget.go @@ -48,12 +48,20 @@ import ( // items: // "$ref": "#/definitions/instanceRule" // '400': +// schema: +// "$ref": "#/definitions/error" // description: bad request // '404': +// schema: +// "$ref": "#/definitions/error" // description: not found // '406': +// schema: +// "$ref": "#/definitions/error" // description: not acceptable // '500': +// schema: +// "$ref": "#/definitions/error" // description: internal server error func (m *Module) InstanceRulesGETHandler(c *gin.Context) { if _, err := apiutil.NegotiateAccept(c, apiutil.JSONAcceptHeaders...); err != nil { diff --git a/internal/api/client/interactionpolicies/getdefaults.go b/internal/api/client/interactionpolicies/getdefaults.go index a5890fc8b..1852c3749 100644 --- a/internal/api/client/interactionpolicies/getdefaults.go +++ b/internal/api/client/interactionpolicies/getdefaults.go @@ -46,10 +46,16 @@ import ( // schema: // "$ref": "#/definitions/defaultPolicies" // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '406': +// schema: +// "$ref": "#/definitions/error" // description: not acceptable // '500': +// schema: +// "$ref": "#/definitions/error" // description: internal server error func (m *Module) PoliciesDefaultsGETHandler(c *gin.Context) { authed, errWithCode := apiutil.TokenAuth(c, diff --git a/internal/api/client/interactionpolicies/updatedefaults.go b/internal/api/client/interactionpolicies/updatedefaults.go index 1b3c0bc7a..128b0501a 100644 --- a/internal/api/client/interactionpolicies/updatedefaults.go +++ b/internal/api/client/interactionpolicies/updatedefaults.go @@ -200,14 +200,24 @@ import ( // schema: // "$ref": "#/definitions/defaultPolicies" // '400': +// schema: +// "$ref": "#/definitions/error" // description: bad request // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '406': +// schema: +// "$ref": "#/definitions/error" // description: not acceptable // '422': +// schema: +// "$ref": "#/definitions/error" // description: unprocessable // '500': +// schema: +// "$ref": "#/definitions/error" // description: internal server error func (m *Module) PoliciesDefaultsPATCHHandler(c *gin.Context) { authed, errWithCode := apiutil.TokenAuth(c, diff --git a/internal/api/client/interactionrequests/authorize.go b/internal/api/client/interactionrequests/authorize.go index 81a612e7a..6b9dfc01b 100644 --- a/internal/api/client/interactionrequests/authorize.go +++ b/internal/api/client/interactionrequests/authorize.go @@ -55,14 +55,24 @@ import ( // schema: // "$ref": "#/definitions/interactionRequest" // '400': +// schema: +// "$ref": "#/definitions/error" // description: bad request // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '404': +// schema: +// "$ref": "#/definitions/error" // description: not found // '406': +// schema: +// "$ref": "#/definitions/error" // description: not acceptable // '500': +// schema: +// "$ref": "#/definitions/error" // description: internal server error func (m *Module) InteractionRequestAuthorizePOSTHandler(c *gin.Context) { authed, errWithCode := apiutil.TokenAuth(c, diff --git a/internal/api/client/interactionrequests/get.go b/internal/api/client/interactionrequests/get.go index a4f09f490..48b1520f8 100644 --- a/internal/api/client/interactionrequests/get.go +++ b/internal/api/client/interactionrequests/get.go @@ -54,14 +54,24 @@ import ( // schema: // "$ref": "#/definitions/interactionRequest" // '400': +// schema: +// "$ref": "#/definitions/error" // description: bad request // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '404': +// schema: +// "$ref": "#/definitions/error" // description: not found // '406': +// schema: +// "$ref": "#/definitions/error" // description: not acceptable // '500': +// schema: +// "$ref": "#/definitions/error" // description: internal server error func (m *Module) InteractionRequestGETHandler(c *gin.Context) { authed, errWithCode := apiutil.TokenAuth(c, diff --git a/internal/api/client/interactionrequests/getpage.go b/internal/api/client/interactionrequests/getpage.go index d938b220f..eeaa635b7 100644 --- a/internal/api/client/interactionrequests/getpage.go +++ b/internal/api/client/interactionrequests/getpage.go @@ -126,14 +126,24 @@ import ( // items: // "$ref": "#/definitions/interactionRequest" // '400': +// schema: +// "$ref": "#/definitions/error" // description: bad request // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '404': +// schema: +// "$ref": "#/definitions/error" // description: not found // '406': +// schema: +// "$ref": "#/definitions/error" // description: not acceptable // '500': +// schema: +// "$ref": "#/definitions/error" // description: internal server error func (m *Module) InteractionRequestsGETHandler(c *gin.Context) { authed, errWithCode := apiutil.TokenAuth(c, diff --git a/internal/api/client/interactionrequests/reject.go b/internal/api/client/interactionrequests/reject.go index 2f87643a1..06ac0d839 100644 --- a/internal/api/client/interactionrequests/reject.go +++ b/internal/api/client/interactionrequests/reject.go @@ -55,14 +55,24 @@ import ( // schema: // "$ref": "#/definitions/interactionRequest" // '400': +// schema: +// "$ref": "#/definitions/error" // description: bad request // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '404': +// schema: +// "$ref": "#/definitions/error" // description: not found // '406': +// schema: +// "$ref": "#/definitions/error" // description: not acceptable // '500': +// schema: +// "$ref": "#/definitions/error" // description: internal server error func (m *Module) InteractionRequestRejectPOSTHandler(c *gin.Context) { authed, errWithCode := apiutil.TokenAuth(c, diff --git a/internal/api/client/lists/listaccounts.go b/internal/api/client/lists/listaccounts.go index ac3f21ef5..b58486f10 100644 --- a/internal/api/client/lists/listaccounts.go +++ b/internal/api/client/lists/listaccounts.go @@ -106,14 +106,24 @@ import ( // items: // "$ref": "#/definitions/account" // '400': +// schema: +// "$ref": "#/definitions/error" // description: bad request // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '404': +// schema: +// "$ref": "#/definitions/error" // description: not found // '406': +// schema: +// "$ref": "#/definitions/error" // description: not acceptable // '500': +// schema: +// "$ref": "#/definitions/error" // description: internal server error func (m *Module) ListAccountsGETHandler(c *gin.Context) { authed, errWithCode := apiutil.TokenAuth(c, diff --git a/internal/api/client/lists/listaccountsadd.go b/internal/api/client/lists/listaccountsadd.go index b89b9100b..7eb7c1e8e 100644 --- a/internal/api/client/lists/listaccountsadd.go +++ b/internal/api/client/lists/listaccountsadd.go @@ -71,14 +71,24 @@ import ( // '200': // description: list accounts updated // '400': +// schema: +// "$ref": "#/definitions/error" // description: bad request // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '404': +// schema: +// "$ref": "#/definitions/error" // description: not found // '406': +// schema: +// "$ref": "#/definitions/error" // description: not acceptable // '500': +// schema: +// "$ref": "#/definitions/error" // description: internal server error func (m *Module) ListAccountsPOSTHandler(c *gin.Context) { authed, errWithCode := apiutil.TokenAuth(c, diff --git a/internal/api/client/lists/listaccountsremove.go b/internal/api/client/lists/listaccountsremove.go index fc4cb0344..a70733809 100644 --- a/internal/api/client/lists/listaccountsremove.go +++ b/internal/api/client/lists/listaccountsremove.go @@ -71,14 +71,24 @@ import ( // '200': // description: list accounts updated // '400': +// schema: +// "$ref": "#/definitions/error" // description: bad request // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '404': +// schema: +// "$ref": "#/definitions/error" // description: not found // '406': +// schema: +// "$ref": "#/definitions/error" // description: not acceptable // '500': +// schema: +// "$ref": "#/definitions/error" // description: internal server error func (m *Module) ListAccountsDELETEHandler(c *gin.Context) { authed, errWithCode := apiutil.TokenAuth(c, diff --git a/internal/api/client/lists/listcreate.go b/internal/api/client/lists/listcreate.go index 75ad48b0c..19a6ffc42 100644 --- a/internal/api/client/lists/listcreate.go +++ b/internal/api/client/lists/listcreate.go @@ -84,16 +84,28 @@ import ( // schema: // "$ref": "#/definitions/list" // '400': +// schema: +// "$ref": "#/definitions/error" // description: bad request // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '403': +// schema: +// "$ref": "#/definitions/error" // description: forbidden // '404': +// schema: +// "$ref": "#/definitions/error" // description: not found // '406': +// schema: +// "$ref": "#/definitions/error" // description: not acceptable // '500': +// schema: +// "$ref": "#/definitions/error" // description: internal server error func (m *Module) ListCreatePOSTHandler(c *gin.Context) { authed, errWithCode := apiutil.TokenAuth(c, diff --git a/internal/api/client/lists/listdelete.go b/internal/api/client/lists/listdelete.go index 7e5b58b58..1cd7f5c4f 100644 --- a/internal/api/client/lists/listdelete.go +++ b/internal/api/client/lists/listdelete.go @@ -53,14 +53,24 @@ import ( // '200': // description: list deleted // '400': +// schema: +// "$ref": "#/definitions/error" // description: bad request // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '404': +// schema: +// "$ref": "#/definitions/error" // description: not found // '406': +// schema: +// "$ref": "#/definitions/error" // description: not acceptable // '500': +// schema: +// "$ref": "#/definitions/error" // description: internal server error func (m *Module) ListDELETEHandler(c *gin.Context) { authed, errWithCode := apiutil.TokenAuth(c, diff --git a/internal/api/client/lists/listget.go b/internal/api/client/lists/listget.go index e8e2759a8..3a1a5d351 100644 --- a/internal/api/client/lists/listget.go +++ b/internal/api/client/lists/listget.go @@ -56,14 +56,24 @@ import ( // schema: // "$ref": "#/definitions/list" // '400': +// schema: +// "$ref": "#/definitions/error" // description: bad request // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '404': +// schema: +// "$ref": "#/definitions/error" // description: not found // '406': +// schema: +// "$ref": "#/definitions/error" // description: not acceptable // '500': +// schema: +// "$ref": "#/definitions/error" // description: internal server error func (m *Module) ListGETHandler(c *gin.Context) { authed, errWithCode := apiutil.TokenAuth(c, diff --git a/internal/api/client/lists/listsget.go b/internal/api/client/lists/listsget.go index 8d912241b..7790953c8 100644 --- a/internal/api/client/lists/listsget.go +++ b/internal/api/client/lists/listsget.go @@ -49,14 +49,24 @@ import ( // items: // "$ref": "#/definitions/list" // '400': +// schema: +// "$ref": "#/definitions/error" // description: bad request // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '404': +// schema: +// "$ref": "#/definitions/error" // description: not found // '406': +// schema: +// "$ref": "#/definitions/error" // description: not acceptable // '500': +// schema: +// "$ref": "#/definitions/error" // description: internal server error func (m *Module) ListsGETHandler(c *gin.Context) { authed, errWithCode := apiutil.TokenAuth(c, diff --git a/internal/api/client/lists/listupdate.go b/internal/api/client/lists/listupdate.go index e4258b013..5ac26cf60 100644 --- a/internal/api/client/lists/listupdate.go +++ b/internal/api/client/lists/listupdate.go @@ -90,16 +90,28 @@ import ( // schema: // "$ref": "#/definitions/list" // '400': +// schema: +// "$ref": "#/definitions/error" // description: bad request // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '403': +// schema: +// "$ref": "#/definitions/error" // description: forbidden // '404': +// schema: +// "$ref": "#/definitions/error" // description: not found // '406': +// schema: +// "$ref": "#/definitions/error" // description: not acceptable // '500': +// schema: +// "$ref": "#/definitions/error" // description: internal server error func (m *Module) ListUpdatePUTHandler(c *gin.Context) { authed, errWithCode := apiutil.TokenAuth(c, diff --git a/internal/api/client/markers/markersget.go b/internal/api/client/markers/markersget.go index 5706e74cd..b0b2297a8 100644 --- a/internal/api/client/markers/markersget.go +++ b/internal/api/client/markers/markersget.go @@ -60,10 +60,16 @@ import ( // schema: // "$ref": "#/definitions/markers" // '400': +// schema: +// "$ref": "#/definitions/error" // description: bad request // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '500': +// schema: +// "$ref": "#/definitions/error" // description: internal server error func (m *Module) MarkersGETHandler(c *gin.Context) { authed, errWithCode := apiutil.TokenAuth(c, diff --git a/internal/api/client/markers/markerspost.go b/internal/api/client/markers/markerspost.go index 199d370d3..d96ffa4be 100644 --- a/internal/api/client/markers/markerspost.go +++ b/internal/api/client/markers/markerspost.go @@ -63,12 +63,20 @@ import ( // schema: // "$ref": "#/definitions/markers" // '400': +// schema: +// "$ref": "#/definitions/error" // description: bad request // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '409': +// schema: +// "$ref": "#/definitions/error" // description: conflict (when two clients try to update the same timeline at the same time) // '500': +// schema: +// "$ref": "#/definitions/error" // description: internal server error func (m *Module) MarkersPOSTHandler(c *gin.Context) { authed, errWithCode := apiutil.TokenAuth(c, diff --git a/internal/api/client/media/mediacreate.go b/internal/api/client/media/mediacreate.go index 5b71dd527..21354ce59 100644 --- a/internal/api/client/media/mediacreate.go +++ b/internal/api/client/media/mediacreate.go @@ -84,12 +84,20 @@ import ( // schema: // "$ref": "#/definitions/attachment" // '400': +// schema: +// "$ref": "#/definitions/error" // description: bad request // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '422': +// schema: +// "$ref": "#/definitions/error" // description: unprocessable // '500': +// schema: +// "$ref": "#/definitions/error" // description: internal server error func (m *Module) MediaCreatePOSTHandler(c *gin.Context) { _, errWithCode := apiutil.ParseAPIVersion( diff --git a/internal/api/client/media/mediaget.go b/internal/api/client/media/mediaget.go index e08ef6bfa..eb676abb2 100644 --- a/internal/api/client/media/mediaget.go +++ b/internal/api/client/media/mediaget.go @@ -55,15 +55,25 @@ import ( // schema: // "$ref": "#/definitions/attachment" // '400': +// schema: +// "$ref": "#/definitions/error" // description: bad request // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '404': +// schema: +// "$ref": "#/definitions/error" // description: not found // '406': +// schema: +// "$ref": "#/definitions/error" // description: not acceptable // '500': -// description: internal server error +// schema: +// "$ref": "#/definitions/error" +// description: internal server error func (m *Module) MediaGETHandler(c *gin.Context) { if _, errWithCode := apiutil.ParseAPIVersion( c.Param(apiutil.APIVersionKey), diff --git a/internal/api/client/media/mediaupdate.go b/internal/api/client/media/mediaupdate.go index d10fc97b1..86ad30d65 100644 --- a/internal/api/client/media/mediaupdate.go +++ b/internal/api/client/media/mediaupdate.go @@ -87,14 +87,24 @@ import ( // schema: // "$ref": "#/definitions/attachment" // '400': +// schema: +// "$ref": "#/definitions/error" // description: bad request // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '404': +// schema: +// "$ref": "#/definitions/error" // description: not found // '406': +// schema: +// "$ref": "#/definitions/error" // description: not acceptable // '500': +// schema: +// "$ref": "#/definitions/error" // description: internal server error func (m *Module) MediaPUTHandler(c *gin.Context) { if _, errWithCode := apiutil.ParseAPIVersion( diff --git a/internal/api/client/mutes/mutesget.go b/internal/api/client/mutes/mutesget.go index 5aa4f99eb..28f6001f9 100644 --- a/internal/api/client/mutes/mutesget.go +++ b/internal/api/client/mutes/mutesget.go @@ -97,14 +97,24 @@ import ( // items: // "$ref": "#/definitions/mutedAccount" // '400': +// schema: +// "$ref": "#/definitions/error" // description: bad request // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '404': +// schema: +// "$ref": "#/definitions/error" // description: not found // '406': +// schema: +// "$ref": "#/definitions/error" // description: not acceptable // '500': +// schema: +// "$ref": "#/definitions/error" // description: internal server error func (m *Module) MutesGETHandler(c *gin.Context) { authed, errWithCode := apiutil.TokenAuth(c, diff --git a/internal/api/client/notifications/notificationget.go b/internal/api/client/notifications/notificationget.go index e9265d1bc..16551b548 100644 --- a/internal/api/client/notifications/notificationget.go +++ b/internal/api/client/notifications/notificationget.go @@ -56,14 +56,24 @@ import ( // schema: // "$ref": "#/definitions/notification" // '400': +// schema: +// "$ref": "#/definitions/error" // description: bad request // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '404': +// schema: +// "$ref": "#/definitions/error" // description: not found // '406': +// schema: +// "$ref": "#/definitions/error" // description: not acceptable // '500': +// schema: +// "$ref": "#/definitions/error" // description: internal server error func (m *Module) NotificationGETHandler(c *gin.Context) { authed, errWithCode := apiutil.TokenAuth(c, diff --git a/internal/api/client/notifications/notificationsclear.go b/internal/api/client/notifications/notificationsclear.go index 58c2c7f70..cff253736 100644 --- a/internal/api/client/notifications/notificationsclear.go +++ b/internal/api/client/notifications/notificationsclear.go @@ -47,14 +47,24 @@ import ( // schema: // type: object // '400': +// schema: +// "$ref": "#/definitions/error" // description: bad request // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '404': +// schema: +// "$ref": "#/definitions/error" // description: not found // '406': +// schema: +// "$ref": "#/definitions/error" // description: not acceptable // '500': +// schema: +// "$ref": "#/definitions/error" // description: internal server error func (m *Module) NotificationsClearPOSTHandler(c *gin.Context) { authed, errWithCode := apiutil.TokenAuth(c, diff --git a/internal/api/client/notifications/notificationsget.go b/internal/api/client/notifications/notificationsget.go index 5550ed082..14ef2726f 100644 --- a/internal/api/client/notifications/notificationsget.go +++ b/internal/api/client/notifications/notificationsget.go @@ -132,14 +132,24 @@ import ( // items: // "$ref": "#/definitions/notification" // '400': +// schema: +// "$ref": "#/definitions/error" // description: bad request // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '404': +// schema: +// "$ref": "#/definitions/error" // description: not found // '406': +// schema: +// "$ref": "#/definitions/error" // description: not acceptable // '500': +// schema: +// "$ref": "#/definitions/error" // description: internal server error func (m *Module) NotificationsGETHandler(c *gin.Context) { authed, errWithCode := apiutil.TokenAuth(c, diff --git a/internal/api/client/polls/polls_get.go b/internal/api/client/polls/polls_get.go index dd3892abc..939aa7bb8 100644 --- a/internal/api/client/polls/polls_get.go +++ b/internal/api/client/polls/polls_get.go @@ -54,16 +54,28 @@ import ( // schema: // "$ref": "#/definitions/poll" // '400': +// schema: +// "$ref": "#/definitions/error" // description: bad request // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '403': +// schema: +// "$ref": "#/definitions/error" // description: forbidden // '404': +// schema: +// "$ref": "#/definitions/error" // description: not found // '406': +// schema: +// "$ref": "#/definitions/error" // description: not acceptable // '500': +// schema: +// "$ref": "#/definitions/error" // description: internal server error func (m *Module) PollGETHandler(c *gin.Context) { authed, errWithCode := apiutil.TokenAuth(c, diff --git a/internal/api/client/polls/polls_vote.go b/internal/api/client/polls/polls_vote.go index 62352fbb0..882fd9063 100644 --- a/internal/api/client/polls/polls_vote.go +++ b/internal/api/client/polls/polls_vote.go @@ -65,18 +65,32 @@ import ( // schema: // "$ref": "#/definitions/poll" // '400': +// schema: +// "$ref": "#/definitions/error" // description: bad request // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '403': +// schema: +// "$ref": "#/definitions/error" // description: forbidden // '404': +// schema: +// "$ref": "#/definitions/error" // description: not found // '406': +// schema: +// "$ref": "#/definitions/error" // description: not acceptable // '422': +// schema: +// "$ref": "#/definitions/error" // description: unprocessable entity // '500': +// schema: +// "$ref": "#/definitions/error" // description: internal server error func (m *Module) PollVotePOSTHandler(c *gin.Context) { authed, errWithCode := apiutil.TokenAuth(c, diff --git a/internal/api/client/preferences/preferencesget.go b/internal/api/client/preferences/preferencesget.go index 06485f53a..7e36f592b 100644 --- a/internal/api/client/preferences/preferencesget.go +++ b/internal/api/client/preferences/preferencesget.go @@ -60,14 +60,24 @@ import ( // schema: // type: object // '400': +// schema: +// "$ref": "#/definitions/error" // description: bad request // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '404': +// schema: +// "$ref": "#/definitions/error" // description: not found // '406': +// schema: +// "$ref": "#/definitions/error" // description: not acceptable // '500': +// schema: +// "$ref": "#/definitions/error" // description: internal server error func (m *Module) PreferencesGETHandler(c *gin.Context) { authed, errWithCode := apiutil.TokenAuth(c, diff --git a/internal/api/client/push/pushsubscriptiondelete.go b/internal/api/client/push/pushsubscriptiondelete.go index 8cafa3e39..3f959842d 100644 --- a/internal/api/client/push/pushsubscriptiondelete.go +++ b/internal/api/client/push/pushsubscriptiondelete.go @@ -41,10 +41,16 @@ import ( // '200': // description: Push subscription deleted, or did not exist. // '400': +// schema: +// "$ref": "#/definitions/error" // description: bad request // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '500': +// schema: +// "$ref": "#/definitions/error" // description: internal server error func (m *Module) PushSubscriptionDELETEHandler(c *gin.Context) { authed, errWithCode := apiutil.TokenAuth(c, diff --git a/internal/api/client/push/pushsubscriptionget.go b/internal/api/client/push/pushsubscriptionget.go index 2a3e69e3d..1150144de 100644 --- a/internal/api/client/push/pushsubscriptionget.go +++ b/internal/api/client/push/pushsubscriptionget.go @@ -45,12 +45,20 @@ import ( // schema: // "$ref": "#/definitions/webPushSubscription" // '400': +// schema: +// "$ref": "#/definitions/error" // description: bad request // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '404': +// schema: +// "$ref": "#/definitions/error" // description: This access token doesn't have an associated subscription. // '500': +// schema: +// "$ref": "#/definitions/error" // description: internal server error func (m *Module) PushSubscriptionGETHandler(c *gin.Context) { authed, errWithCode := apiutil.TokenAuth(c, diff --git a/internal/api/client/push/pushsubscriptionpost.go b/internal/api/client/push/pushsubscriptionpost.go index 1929ae714..83ef3ee41 100644 --- a/internal/api/client/push/pushsubscriptionpost.go +++ b/internal/api/client/push/pushsubscriptionpost.go @@ -168,16 +168,28 @@ import ( // schema: // "$ref": "#/definitions/webPushSubscription" // '400': +// schema: +// "$ref": "#/definitions/error" // description: bad request // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '403': +// schema: +// "$ref": "#/definitions/error" // description: forbidden // '404': +// schema: +// "$ref": "#/definitions/error" // description: not found // '406': +// schema: +// "$ref": "#/definitions/error" // description: not acceptable // '500': +// schema: +// "$ref": "#/definitions/error" // description: internal server error func (m *Module) PushSubscriptionPOSTHandler(c *gin.Context) { authed, errWithCode := apiutil.TokenAuth(c, diff --git a/internal/api/client/push/pushsubscriptionput.go b/internal/api/client/push/pushsubscriptionput.go index 1a2b51cb7..7100199d5 100644 --- a/internal/api/client/push/pushsubscriptionput.go +++ b/internal/api/client/push/pushsubscriptionput.go @@ -144,16 +144,28 @@ import ( // schema: // "$ref": "#/definitions/webPushSubscription" // '400': +// schema: +// "$ref": "#/definitions/error" // description: bad request // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '403': +// schema: +// "$ref": "#/definitions/error" // description: forbidden // '404': +// schema: +// "$ref": "#/definitions/error" // description: This access token doesn't have an associated subscription. // '406': +// schema: +// "$ref": "#/definitions/error" // description: not acceptable // '500': +// schema: +// "$ref": "#/definitions/error" // description: internal server error func (m *Module) PushSubscriptionPUTHandler(c *gin.Context) { authed, errWithCode := apiutil.TokenAuth(c, diff --git a/internal/api/client/reports/reportcreate.go b/internal/api/client/reports/reportcreate.go index 51e29a1b5..0ed4a00c8 100644 --- a/internal/api/client/reports/reportcreate.go +++ b/internal/api/client/reports/reportcreate.go @@ -55,14 +55,24 @@ import ( // schema: // "$ref": "#/definitions/report" // '400': +// schema: +// "$ref": "#/definitions/error" // description: bad request // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '404': +// schema: +// "$ref": "#/definitions/error" // description: not found // '406': +// schema: +// "$ref": "#/definitions/error" // description: not acceptable // '500': +// schema: +// "$ref": "#/definitions/error" // description: internal server error func (m *Module) ReportPOSTHandler(c *gin.Context) { authed, errWithCode := apiutil.TokenAuth(c, diff --git a/internal/api/client/reports/reportget.go b/internal/api/client/reports/reportget.go index abb677a31..8a0fa5ae3 100644 --- a/internal/api/client/reports/reportget.go +++ b/internal/api/client/reports/reportget.go @@ -54,14 +54,24 @@ import ( // schema: // "$ref": "#/definitions/report" // '400': +// schema: +// "$ref": "#/definitions/error" // description: bad request // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '404': +// schema: +// "$ref": "#/definitions/error" // description: not found // '406': +// schema: +// "$ref": "#/definitions/error" // description: not acceptable // '500': +// schema: +// "$ref": "#/definitions/error" // description: internal server error func (m *Module) ReportGETHandler(c *gin.Context) { authed, errWithCode := apiutil.TokenAuth(c, diff --git a/internal/api/client/reports/reportsget.go b/internal/api/client/reports/reportsget.go index 7d35fbd03..49a8ab163 100644 --- a/internal/api/client/reports/reportsget.go +++ b/internal/api/client/reports/reportsget.go @@ -108,14 +108,24 @@ import ( // type: string // description: Links to the next and previous queries. // '400': +// schema: +// "$ref": "#/definitions/error" // description: bad request // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '404': +// schema: +// "$ref": "#/definitions/error" // description: not found // '406': +// schema: +// "$ref": "#/definitions/error" // description: not acceptable // '500': +// schema: +// "$ref": "#/definitions/error" // description: internal server error func (m *Module) ReportsGETHandler(c *gin.Context) { authed, errWithCode := apiutil.TokenAuth(c, diff --git a/internal/api/client/scheduledstatuses/scheduledstatusdelete.go b/internal/api/client/scheduledstatuses/scheduledstatusdelete.go index efd645e2a..835eef453 100644 --- a/internal/api/client/scheduledstatuses/scheduledstatusdelete.go +++ b/internal/api/client/scheduledstatuses/scheduledstatusdelete.go @@ -53,14 +53,24 @@ import ( // '200': // description: status canceled // '400': +// schema: +// "$ref": "#/definitions/error" // description: bad request // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '404': +// schema: +// "$ref": "#/definitions/error" // description: not found // '406': +// schema: +// "$ref": "#/definitions/error" // description: not acceptable // '500': +// schema: +// "$ref": "#/definitions/error" // description: internal server error func (m *Module) ScheduledStatusDELETEHandler(c *gin.Context) { authed, errWithCode := apiutil.TokenAuth(c, diff --git a/internal/api/client/scheduledstatuses/scheduledstatusesget.go b/internal/api/client/scheduledstatuses/scheduledstatusesget.go index 6d08ff18b..ead8f22fb 100644 --- a/internal/api/client/scheduledstatuses/scheduledstatusesget.go +++ b/internal/api/client/scheduledstatuses/scheduledstatusesget.go @@ -84,14 +84,24 @@ import ( // items: // "$ref": "#/definitions/scheduledStatus" // '400': +// schema: +// "$ref": "#/definitions/error" // description: bad request // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '404': +// schema: +// "$ref": "#/definitions/error" // description: not found // '406': +// schema: +// "$ref": "#/definitions/error" // description: not acceptable // '500': +// schema: +// "$ref": "#/definitions/error" // description: internal server error func (m *Module) ScheduledStatusesGETHandler(c *gin.Context) { authed, errWithCode := apiutil.TokenAuth(c, diff --git a/internal/api/client/scheduledstatuses/scheduledstatusget.go b/internal/api/client/scheduledstatuses/scheduledstatusget.go index 893c44938..16399f0a5 100644 --- a/internal/api/client/scheduledstatuses/scheduledstatusget.go +++ b/internal/api/client/scheduledstatuses/scheduledstatusget.go @@ -54,14 +54,24 @@ import ( // schema: // "$ref": "#/definitions/scheduledStatus" // '400': +// schema: +// "$ref": "#/definitions/error" // description: bad request // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '404': +// schema: +// "$ref": "#/definitions/error" // description: not found // '406': +// schema: +// "$ref": "#/definitions/error" // description: not acceptable // '500': +// schema: +// "$ref": "#/definitions/error" // description: internal server error func (m *Module) ScheduledStatusGETHandler(c *gin.Context) { authed, errWithCode := apiutil.TokenAuth(c, diff --git a/internal/api/client/scheduledstatuses/scheduledstatusput.go b/internal/api/client/scheduledstatuses/scheduledstatusput.go index 7b458a8d2..2042bd397 100644 --- a/internal/api/client/scheduledstatuses/scheduledstatusput.go +++ b/internal/api/client/scheduledstatuses/scheduledstatusput.go @@ -66,16 +66,28 @@ import ( // schema: // "$ref": "#/definitions/scheduledStatus" // '400': +// schema: +// "$ref": "#/definitions/error" // description: bad request // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '404': +// schema: +// "$ref": "#/definitions/error" // description: not found // '406': +// schema: +// "$ref": "#/definitions/error" // description: not acceptable // '422': +// schema: +// "$ref": "#/definitions/error" // description: unprocessable content // '500': +// schema: +// "$ref": "#/definitions/error" // description: internal server error func (m *Module) ScheduledStatusPUTHandler(c *gin.Context) { authed, errWithCode := apiutil.TokenAuth(c, diff --git a/internal/api/client/search/searchget.go b/internal/api/client/search/searchget.go index a5dc2527f..11dd98e99 100644 --- a/internal/api/client/search/searchget.go +++ b/internal/api/client/search/searchget.go @@ -158,14 +158,24 @@ import ( // schema: // "$ref": "#/definitions/searchResult" // '400': +// schema: +// "$ref": "#/definitions/error" // description: bad request // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '404': +// schema: +// "$ref": "#/definitions/error" // description: not found // '406': +// schema: +// "$ref": "#/definitions/error" // description: not acceptable // '500': +// schema: +// "$ref": "#/definitions/error" // description: internal server error func (m *Module) SearchGETHandler(c *gin.Context) { apiVersion, errWithCode := apiutil.ParseAPIVersion( diff --git a/internal/api/client/statuses/statusbookmark.go b/internal/api/client/statuses/statusbookmark.go index 804044763..e05fbc31d 100644 --- a/internal/api/client/statuses/statusbookmark.go +++ b/internal/api/client/statuses/statusbookmark.go @@ -56,16 +56,28 @@ import ( // schema: // "$ref": "#/definitions/status" // '400': +// schema: +// "$ref": "#/definitions/error" // description: bad request // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '403': +// schema: +// "$ref": "#/definitions/error" // description: forbidden // '404': +// schema: +// "$ref": "#/definitions/error" // description: not found // '406': +// schema: +// "$ref": "#/definitions/error" // description: not acceptable // '500': +// schema: +// "$ref": "#/definitions/error" // description: internal server error func (m *Module) StatusBookmarkPOSTHandler(c *gin.Context) { authed, errWithCode := apiutil.TokenAuth(c, diff --git a/internal/api/client/statuses/statusboost.go b/internal/api/client/statuses/statusboost.go index 5e8418dec..559bef95e 100644 --- a/internal/api/client/statuses/statusboost.go +++ b/internal/api/client/statuses/statusboost.go @@ -59,16 +59,28 @@ import ( // schema: // "$ref": "#/definitions/status" // '400': +// schema: +// "$ref": "#/definitions/error" // description: bad request // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '403': +// schema: +// "$ref": "#/definitions/error" // description: forbidden // '404': +// schema: +// "$ref": "#/definitions/error" // description: not found // '406': +// schema: +// "$ref": "#/definitions/error" // description: not acceptable // '500': +// schema: +// "$ref": "#/definitions/error" // description: internal server error func (m *Module) StatusBoostPOSTHandler(c *gin.Context) { authed, errWithCode := apiutil.TokenAuth(c, diff --git a/internal/api/client/statuses/statusboostedby.go b/internal/api/client/statuses/statusboostedby.go index 70111afcc..33bfd333e 100644 --- a/internal/api/client/statuses/statusboostedby.go +++ b/internal/api/client/statuses/statusboostedby.go @@ -56,12 +56,20 @@ import ( // items: // "$ref": "#/definitions/account" // '400': +// schema: +// "$ref": "#/definitions/error" // description: bad request // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '403': +// schema: +// "$ref": "#/definitions/error" // description: forbidden // '404': +// schema: +// "$ref": "#/definitions/error" // description: not found func (m *Module) StatusBoostedByGETHandler(c *gin.Context) { authed, errWithCode := apiutil.TokenAuth(c, diff --git a/internal/api/client/statuses/statuscontext.go b/internal/api/client/statuses/statuscontext.go index 4a5e8abf3..fe8f0f217 100644 --- a/internal/api/client/statuses/statuscontext.go +++ b/internal/api/client/statuses/statuscontext.go @@ -58,16 +58,28 @@ import ( // schema: // "$ref": "#/definitions/threadContext" // '400': +// schema: +// "$ref": "#/definitions/error" // description: bad request // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '403': +// schema: +// "$ref": "#/definitions/error" // description: forbidden // '404': +// schema: +// "$ref": "#/definitions/error" // description: not found // '406': +// schema: +// "$ref": "#/definitions/error" // description: not acceptable // '500': +// schema: +// "$ref": "#/definitions/error" // description: internal server error func (m *Module) StatusContextGETHandler(c *gin.Context) { authed, errWithCode := apiutil.TokenAuth(c, diff --git a/internal/api/client/statuses/statuscreate.go b/internal/api/client/statuses/statuscreate.go index de06d2d8b..8b3c937a0 100644 --- a/internal/api/client/statuses/statuscreate.go +++ b/internal/api/client/statuses/statuscreate.go @@ -247,18 +247,32 @@ import ( // schema: // "$ref": "#/definitions/status" // '400': +// schema: +// "$ref": "#/definitions/error" // description: bad request // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '403': +// schema: +// "$ref": "#/definitions/error" // description: forbidden // '404': +// schema: +// "$ref": "#/definitions/error" // description: not found // '406': +// schema: +// "$ref": "#/definitions/error" // description: not acceptable // '422': +// schema: +// "$ref": "#/definitions/error" // description: unprocessable content // '500': +// schema: +// "$ref": "#/definitions/error" // description: internal server error func (m *Module) StatusCreatePOSTHandler(c *gin.Context) { authed, errWithCode := apiutil.TokenAuth(c, diff --git a/internal/api/client/statuses/statusdelete.go b/internal/api/client/statuses/statusdelete.go index 006b6e601..5148da370 100644 --- a/internal/api/client/statuses/statusdelete.go +++ b/internal/api/client/statuses/statusdelete.go @@ -58,16 +58,28 @@ import ( // schema: // "$ref": "#/definitions/status" // '400': +// schema: +// "$ref": "#/definitions/error" // description: bad request // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '403': +// schema: +// "$ref": "#/definitions/error" // description: forbidden // '404': +// schema: +// "$ref": "#/definitions/error" // description: not found // '406': +// schema: +// "$ref": "#/definitions/error" // description: not acceptable // '500': +// schema: +// "$ref": "#/definitions/error" // description: internal server error func (m *Module) StatusDELETEHandler(c *gin.Context) { authed, errWithCode := apiutil.TokenAuth(c, diff --git a/internal/api/client/statuses/statusedit.go b/internal/api/client/statuses/statusedit.go index 22d22da71..bf9c36dd7 100644 --- a/internal/api/client/statuses/statusedit.go +++ b/internal/api/client/statuses/statusedit.go @@ -149,16 +149,28 @@ import ( // schema: // "$ref": "#/definitions/status" // '400': +// schema: +// "$ref": "#/definitions/error" // description: bad request // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '403': +// schema: +// "$ref": "#/definitions/error" // description: forbidden // '404': +// schema: +// "$ref": "#/definitions/error" // description: not found // '406': +// schema: +// "$ref": "#/definitions/error" // description: not acceptable // '500': +// schema: +// "$ref": "#/definitions/error" // description: internal server error func (m *Module) StatusEditPUTHandler(c *gin.Context) { authed, errWithCode := apiutil.TokenAuth(c, diff --git a/internal/api/client/statuses/statusfave.go b/internal/api/client/statuses/statusfave.go index 592eb86b2..13a44bab7 100644 --- a/internal/api/client/statuses/statusfave.go +++ b/internal/api/client/statuses/statusfave.go @@ -55,16 +55,28 @@ import ( // schema: // "$ref": "#/definitions/status" // '400': +// schema: +// "$ref": "#/definitions/error" // description: bad request // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '403': +// schema: +// "$ref": "#/definitions/error" // description: forbidden // '404': +// schema: +// "$ref": "#/definitions/error" // description: not found // '406': +// schema: +// "$ref": "#/definitions/error" // description: not acceptable // '500': +// schema: +// "$ref": "#/definitions/error" // description: internal server error func (m *Module) StatusFavePOSTHandler(c *gin.Context) { authed, errWithCode := apiutil.TokenAuth(c, diff --git a/internal/api/client/statuses/statusfavedby.go b/internal/api/client/statuses/statusfavedby.go index baa1bcf0d..3deb18f91 100644 --- a/internal/api/client/statuses/statusfavedby.go +++ b/internal/api/client/statuses/statusfavedby.go @@ -56,16 +56,28 @@ import ( // items: // "$ref": "#/definitions/account" // '400': +// schema: +// "$ref": "#/definitions/error" // description: bad request // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '403': +// schema: +// "$ref": "#/definitions/error" // description: forbidden // '404': +// schema: +// "$ref": "#/definitions/error" // description: not found // '406': +// schema: +// "$ref": "#/definitions/error" // description: not acceptable // '500': +// schema: +// "$ref": "#/definitions/error" // description: internal server error func (m *Module) StatusFavedByGETHandler(c *gin.Context) { authed, errWithCode := apiutil.TokenAuth(c, diff --git a/internal/api/client/statuses/statusget.go b/internal/api/client/statuses/statusget.go index ac91f6e44..369d3d3f3 100644 --- a/internal/api/client/statuses/statusget.go +++ b/internal/api/client/statuses/statusget.go @@ -55,16 +55,28 @@ import ( // schema: // "$ref": "#/definitions/status" // '400': +// schema: +// "$ref": "#/definitions/error" // description: bad request // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '403': +// schema: +// "$ref": "#/definitions/error" // description: forbidden // '404': +// schema: +// "$ref": "#/definitions/error" // description: not found // '406': +// schema: +// "$ref": "#/definitions/error" // description: not acceptable // '500': +// schema: +// "$ref": "#/definitions/error" // description: internal server error func (m *Module) StatusGETHandler(c *gin.Context) { authed, errWithCode := apiutil.TokenAuth(c, diff --git a/internal/api/client/statuses/statushistory.go b/internal/api/client/statuses/statushistory.go index 2f94d38d1..bca7f5565 100644 --- a/internal/api/client/statuses/statushistory.go +++ b/internal/api/client/statuses/statushistory.go @@ -55,16 +55,28 @@ import ( // items: // "$ref": "#/definitions/statusEdit" // '400': +// schema: +// "$ref": "#/definitions/error" // description: bad request // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '403': +// schema: +// "$ref": "#/definitions/error" // description: forbidden // '404': +// schema: +// "$ref": "#/definitions/error" // description: not found // '406': +// schema: +// "$ref": "#/definitions/error" // description: not acceptable // '500': +// schema: +// "$ref": "#/definitions/error" // description: internal server error func (m *Module) StatusHistoryGETHandler(c *gin.Context) { authed, errWithCode := apiutil.TokenAuth(c, diff --git a/internal/api/client/statuses/statusmute.go b/internal/api/client/statuses/statusmute.go index a73029f7c..50a925b01 100644 --- a/internal/api/client/statuses/statusmute.go +++ b/internal/api/client/statuses/statusmute.go @@ -59,16 +59,28 @@ import ( // schema: // "$ref": "#/definitions/status" // '400': +// schema: +// "$ref": "#/definitions/error" // description: bad request; you're not part of the target status thread // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '403': +// schema: +// "$ref": "#/definitions/error" // description: forbidden // '404': +// schema: +// "$ref": "#/definitions/error" // description: not found // '406': +// schema: +// "$ref": "#/definitions/error" // description: not acceptable // '500': +// schema: +// "$ref": "#/definitions/error" // description: internal server error func (m *Module) StatusMutePOSTHandler(c *gin.Context) { authed, errWithCode := apiutil.TokenAuth(c, diff --git a/internal/api/client/statuses/statuspin.go b/internal/api/client/statuses/statuspin.go index b12842ef2..1739d4cf5 100644 --- a/internal/api/client/statuses/statuspin.go +++ b/internal/api/client/statuses/statuspin.go @@ -61,16 +61,28 @@ import ( // schema: // "$ref": "#/definitions/status" // '400': +// schema: +// "$ref": "#/definitions/error" // description: bad request // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '403': +// schema: +// "$ref": "#/definitions/error" // description: forbidden // '404': +// schema: +// "$ref": "#/definitions/error" // description: not found // '406': +// schema: +// "$ref": "#/definitions/error" // description: not acceptable // '500': +// schema: +// "$ref": "#/definitions/error" // description: internal server error func (m *Module) StatusPinPOSTHandler(c *gin.Context) { authed, errWithCode := apiutil.TokenAuth(c, diff --git a/internal/api/client/statuses/statussource.go b/internal/api/client/statuses/statussource.go index aed57098f..98cc68adb 100644 --- a/internal/api/client/statuses/statussource.go +++ b/internal/api/client/statuses/statussource.go @@ -55,16 +55,28 @@ import ( // items: // "$ref": "#/definitions/statusSource" // '400': +// schema: +// "$ref": "#/definitions/error" // description: bad request // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '403': +// schema: +// "$ref": "#/definitions/error" // description: forbidden // '404': +// schema: +// "$ref": "#/definitions/error" // description: not found // '406': +// schema: +// "$ref": "#/definitions/error" // description: not acceptable // '500': +// schema: +// "$ref": "#/definitions/error" // description: internal server error func (m *Module) StatusSourceGETHandler(c *gin.Context) { authed, errWithCode := apiutil.TokenAuth(c, diff --git a/internal/api/client/statuses/statusunbookmark.go b/internal/api/client/statuses/statusunbookmark.go index 695600edf..4780b5146 100644 --- a/internal/api/client/statuses/statusunbookmark.go +++ b/internal/api/client/statuses/statusunbookmark.go @@ -56,16 +56,28 @@ import ( // schema: // "$ref": "#/definitions/status" // '400': +// schema: +// "$ref": "#/definitions/error" // description: bad request // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '403': +// schema: +// "$ref": "#/definitions/error" // description: forbidden // '404': +// schema: +// "$ref": "#/definitions/error" // description: not found // '406': +// schema: +// "$ref": "#/definitions/error" // description: not acceptable // '500': +// schema: +// "$ref": "#/definitions/error" // description: internal server error func (m *Module) StatusUnbookmarkPOSTHandler(c *gin.Context) { authed, errWithCode := apiutil.TokenAuth(c, diff --git a/internal/api/client/statuses/statusunboost.go b/internal/api/client/statuses/statusunboost.go index 7863696df..5c08d848a 100644 --- a/internal/api/client/statuses/statusunboost.go +++ b/internal/api/client/statuses/statusunboost.go @@ -56,16 +56,28 @@ import ( // schema: // "$ref": "#/definitions/status" // '400': +// schema: +// "$ref": "#/definitions/error" // description: bad request // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '403': +// schema: +// "$ref": "#/definitions/error" // description: forbidden // '404': +// schema: +// "$ref": "#/definitions/error" // description: not found // '406': +// schema: +// "$ref": "#/definitions/error" // description: not acceptable // '500': +// schema: +// "$ref": "#/definitions/error" // description: internal server error func (m *Module) StatusUnboostPOSTHandler(c *gin.Context) { authed, errWithCode := apiutil.TokenAuth(c, diff --git a/internal/api/client/statuses/statusunfave.go b/internal/api/client/statuses/statusunfave.go index a19c56eed..be990fb08 100644 --- a/internal/api/client/statuses/statusunfave.go +++ b/internal/api/client/statuses/statusunfave.go @@ -55,16 +55,28 @@ import ( // schema: // "$ref": "#/definitions/status" // '400': +// schema: +// "$ref": "#/definitions/error" // description: bad request // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '403': +// schema: +// "$ref": "#/definitions/error" // description: forbidden // '404': +// schema: +// "$ref": "#/definitions/error" // description: not found // '406': +// schema: +// "$ref": "#/definitions/error" // description: not acceptable // '500': +// schema: +// "$ref": "#/definitions/error" // description: internal server error func (m *Module) StatusUnfavePOSTHandler(c *gin.Context) { authed, errWithCode := apiutil.TokenAuth(c, diff --git a/internal/api/client/statuses/statusunmute.go b/internal/api/client/statuses/statusunmute.go index e1e89da3b..0f9689083 100644 --- a/internal/api/client/statuses/statusunmute.go +++ b/internal/api/client/statuses/statusunmute.go @@ -59,16 +59,28 @@ import ( // schema: // "$ref": "#/definitions/status" // '400': +// schema: +// "$ref": "#/definitions/error" // description: bad request; you're not part of the target status thread // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '403': +// schema: +// "$ref": "#/definitions/error" // description: forbidden // '404': +// schema: +// "$ref": "#/definitions/error" // description: not found // '406': +// schema: +// "$ref": "#/definitions/error" // description: not acceptable // '500': +// schema: +// "$ref": "#/definitions/error" // description: internal server error func (m *Module) StatusUnmutePOSTHandler(c *gin.Context) { authed, errWithCode := apiutil.TokenAuth(c, diff --git a/internal/api/client/statuses/statusunpin.go b/internal/api/client/statuses/statusunpin.go index 90d1e7b7f..80d9fe41b 100644 --- a/internal/api/client/statuses/statusunpin.go +++ b/internal/api/client/statuses/statusunpin.go @@ -56,16 +56,28 @@ import ( // schema: // "$ref": "#/definitions/status" // '400': +// schema: +// "$ref": "#/definitions/error" // description: bad request // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '403': +// schema: +// "$ref": "#/definitions/error" // description: forbidden // '404': +// schema: +// "$ref": "#/definitions/error" // description: not found // '406': +// schema: +// "$ref": "#/definitions/error" // description: not acceptable // '500': +// schema: +// "$ref": "#/definitions/error" // description: internal server error func (m *Module) StatusUnpinPOSTHandler(c *gin.Context) { authed, errWithCode := apiutil.TokenAuth(c, diff --git a/internal/api/client/streaming/stream.go b/internal/api/client/streaming/stream.go index 5d7f17f94..7af540651 100644 --- a/internal/api/client/streaming/stream.go +++ b/internal/api/client/streaming/stream.go @@ -149,8 +149,12 @@ var pingMsg = []byte("ping!") // type: string // example: "{\"id\":\"01FC3TZ5CFG6H65GCKCJRKA669\",\"created_at\":\"2021-08-02T16:25:52Z\",\"sensitive\":false,\"spoiler_text\":\"\",\"visibility\":\"public\",\"language\":\"en\",\"uri\":\"https://gts.superseriousbusiness.org/users/dumpsterqueer/statuses/01FC3TZ5CFG6H65GCKCJRKA669\",\"url\":\"https://gts.superseriousbusiness.org/@dumpsterqueer/statuses/01FC3TZ5CFG6H65GCKCJRKA669\",\"replies_count\":0,\"reblogs_count\":0,\"favourites_count\":0,\"favourited\":false,\"reblogged\":false,\"muted\":false,\"bookmarked\":fals…//gts.superseriousbusiness.org/fileserver/01JNN207W98SGG3CBJ76R5MVDN/header/original/019036W043D8FXPJKSKCX7G965.png\",\"header_static\":\"https://gts.superseriousbusiness.org/fileserver/01JNN207W98SGG3CBJ76R5MVDN/header/small/019036W043D8FXPJKSKCX7G965.png\",\"followers_count\":33,\"following_count\":28,\"statuses_count\":126,\"last_status_at\":\"2021-08-02T16:25:52Z\",\"emojis\":[],\"fields\":[]},\"media_attachments\":[],\"mentions\":[],\"tags\":[],\"emojis\":[],\"card\":null,\"poll\":null,\"text\":\"a\"}" // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '400': +// schema: +// "$ref": "#/definitions/error" // description: bad request func (m *Module) StreamGETHandler(c *gin.Context) { var ( diff --git a/internal/api/client/suggestions/suggestions.go b/internal/api/client/suggestions/suggestions.go index 1a63d900e..84e48e4db 100644 --- a/internal/api/client/suggestions/suggestions.go +++ b/internal/api/client/suggestions/suggestions.go @@ -65,10 +65,16 @@ func New(processor *processing.Processor) *Module { // type: object // maxItems: 0 // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '403': +// schema: +// "$ref": "#/definitions/error" // description: forbidden // '406': +// schema: +// "$ref": "#/definitions/error" // description: not acceptable func (m *Module) SuggestionsGETHandler(c *gin.Context) { _, errWithCode := apiutil.TokenAuth(c, diff --git a/internal/api/client/tags/follow.go b/internal/api/client/tags/follow.go index f8b81780a..e621378e0 100644 --- a/internal/api/client/tags/follow.go +++ b/internal/api/client/tags/follow.go @@ -55,12 +55,20 @@ import ( // schema: // "$ref": "#/definitions/tag" // '400': +// schema: +// "$ref": "#/definitions/error" // description: bad request // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '403': +// schema: +// "$ref": "#/definitions/error" // description: forbidden // '500': +// schema: +// "$ref": "#/definitions/error" // description: internal server error func (m *Module) FollowTagPOSTHandler(c *gin.Context) { authed, errWithCode := apiutil.TokenAuth(c, diff --git a/internal/api/client/tags/get.go b/internal/api/client/tags/get.go index 0a88a418d..20ced1414 100644 --- a/internal/api/client/tags/get.go +++ b/internal/api/client/tags/get.go @@ -54,14 +54,24 @@ import ( // schema: // "$ref": "#/definitions/tag" // '400': +// schema: +// "$ref": "#/definitions/error" // description: bad request // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '404': +// schema: +// "$ref": "#/definitions/error" // description: not found // '406': +// schema: +// "$ref": "#/definitions/error" // description: not acceptable // '500': +// schema: +// "$ref": "#/definitions/error" // description: internal server error func (m *Module) TagGETHandler(c *gin.Context) { authed, errWithCode := apiutil.TokenAuth(c, diff --git a/internal/api/client/tags/unfollow.go b/internal/api/client/tags/unfollow.go index 1dd0e6a9d..81c09b588 100644 --- a/internal/api/client/tags/unfollow.go +++ b/internal/api/client/tags/unfollow.go @@ -55,14 +55,24 @@ import ( // schema: // "$ref": "#/definitions/tag" // '400': +// schema: +// "$ref": "#/definitions/error" // description: bad request // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '403': +// schema: +// "$ref": "#/definitions/error" // description: forbidden // '404': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '500': +// schema: +// "$ref": "#/definitions/error" // description: internal server error func (m *Module) UnfollowTagPOSTHandler(c *gin.Context) { authed, errWithCode := apiutil.TokenAuth(c, diff --git a/internal/api/client/timelines/home.go b/internal/api/client/timelines/home.go index 9a7276bdd..bfc1c7479 100644 --- a/internal/api/client/timelines/home.go +++ b/internal/api/client/timelines/home.go @@ -103,8 +103,12 @@ import ( // type: string // description: Links to the next and previous queries. // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '400': +// schema: +// "$ref": "#/definitions/error" // description: bad request func (m *Module) HomeTimelineGETHandler(c *gin.Context) { authed, errWithCode := apiutil.TokenAuth(c, diff --git a/internal/api/client/timelines/list.go b/internal/api/client/timelines/list.go index e76107f1d..e2f77ce1d 100644 --- a/internal/api/client/timelines/list.go +++ b/internal/api/client/timelines/list.go @@ -102,8 +102,12 @@ import ( // type: string // description: Links to the next and previous queries. // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '400': +// schema: +// "$ref": "#/definitions/error" // description: bad request func (m *Module) ListTimelineGETHandler(c *gin.Context) { authed, errWithCode := apiutil.TokenAuth(c, diff --git a/internal/api/client/timelines/public.go b/internal/api/client/timelines/public.go index 5fa32ac03..4d8dead7c 100644 --- a/internal/api/client/timelines/public.go +++ b/internal/api/client/timelines/public.go @@ -104,8 +104,12 @@ import ( // type: string // description: Links to the next and previous queries. // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '400': +// schema: +// "$ref": "#/definitions/error" // description: bad request func (m *Module) PublicTimelineGETHandler(c *gin.Context) { var ( diff --git a/internal/api/client/timelines/tag.go b/internal/api/client/timelines/tag.go index daf88f528..8e77dd2fb 100644 --- a/internal/api/client/timelines/tag.go +++ b/internal/api/client/timelines/tag.go @@ -103,8 +103,12 @@ import ( // type: string // description: Links to the next and previous queries. // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '400': +// schema: +// "$ref": "#/definitions/error" // description: bad request func (m *Module) TagTimelineGETHandler(c *gin.Context) { authed, errWithCode := apiutil.TokenAuth(c, diff --git a/internal/api/client/tokens/tokenget.go b/internal/api/client/tokens/tokenget.go index c0ef980a3..6f9774dee 100644 --- a/internal/api/client/tokens/tokenget.go +++ b/internal/api/client/tokens/tokenget.go @@ -54,14 +54,24 @@ import ( // schema: // "$ref": "#/definitions/tokenInfo" // '400': +// schema: +// "$ref": "#/definitions/error" // description: bad request // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '404': +// schema: +// "$ref": "#/definitions/error" // description: not found // '406': +// schema: +// "$ref": "#/definitions/error" // description: not acceptable // '500': +// schema: +// "$ref": "#/definitions/error" // description: internal server error func (m *Module) TokenInfoGETHandler(c *gin.Context) { authed, errWithCode := apiutil.TokenAuth(c, diff --git a/internal/api/client/tokens/tokeninvalidate.go b/internal/api/client/tokens/tokeninvalidate.go index e705e2635..702b83125 100644 --- a/internal/api/client/tokens/tokeninvalidate.go +++ b/internal/api/client/tokens/tokeninvalidate.go @@ -54,14 +54,24 @@ import ( // schema: // "$ref": "#/definitions/tokenInfo" // '400': +// schema: +// "$ref": "#/definitions/error" // description: bad request // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '404': +// schema: +// "$ref": "#/definitions/error" // description: not found // '406': +// schema: +// "$ref": "#/definitions/error" // description: not acceptable // '500': +// schema: +// "$ref": "#/definitions/error" // description: internal server error func (m *Module) TokenInvalidatePOSTHandler(c *gin.Context) { authed, errWithCode := apiutil.TokenAuth(c, diff --git a/internal/api/client/tokens/tokensget.go b/internal/api/client/tokens/tokensget.go index ee85c730f..b04e2deb0 100644 --- a/internal/api/client/tokens/tokensget.go +++ b/internal/api/client/tokens/tokensget.go @@ -98,8 +98,12 @@ import ( // type: string // description: Links to the next and previous queries. // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '400': +// schema: +// "$ref": "#/definitions/error" // description: bad request func (m *Module) TokensInfoGETHandler(c *gin.Context) { authed, errWithCode := apiutil.TokenAuth(c, diff --git a/internal/api/client/trends/links.go b/internal/api/client/trends/links.go index 72444538e..3a8b77dcb 100644 --- a/internal/api/client/trends/links.go +++ b/internal/api/client/trends/links.go @@ -46,6 +46,8 @@ import ( // type: object // maxItems: 0 // '406': +// schema: +// "$ref": "#/definitions/error" // description: not acceptable func (m *Module) LinksGETHandler(c *gin.Context) { if _, err := apiutil.NegotiateAccept(c, apiutil.JSONAcceptHeaders...); err != nil { diff --git a/internal/api/client/trends/statuses.go b/internal/api/client/trends/statuses.go index f8282095e..9e79e5072 100644 --- a/internal/api/client/trends/statuses.go +++ b/internal/api/client/trends/statuses.go @@ -46,6 +46,8 @@ import ( // type: object // maxItems: 0 // '406': +// schema: +// "$ref": "#/definitions/error" // description: not acceptable func (m *Module) StatusesGETHandler(c *gin.Context) { if _, err := apiutil.NegotiateAccept(c, apiutil.JSONAcceptHeaders...); err != nil { diff --git a/internal/api/client/trends/tags.go b/internal/api/client/trends/tags.go index a309082bf..aa2fa81ef 100644 --- a/internal/api/client/trends/tags.go +++ b/internal/api/client/trends/tags.go @@ -46,6 +46,8 @@ import ( // type: object // maxItems: 0 // '406': +// schema: +// "$ref": "#/definitions/error" // description: not acceptable func (m *Module) TagsGETHandler(c *gin.Context) { if _, err := apiutil.NegotiateAccept(c, apiutil.JSONAcceptHeaders...); err != nil { diff --git a/internal/api/client/user/emailchange.go b/internal/api/client/user/emailchange.go index d0238824d..96895af10 100644 --- a/internal/api/client/user/emailchange.go +++ b/internal/api/client/user/emailchange.go @@ -53,16 +53,28 @@ import ( // schema: // "$ref": "#/definitions/user" // '400': +// schema: +// "$ref": "#/definitions/error" // description: bad request // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '403': +// schema: +// "$ref": "#/definitions/error" // description: forbidden // '406': +// schema: +// "$ref": "#/definitions/error" // description: not acceptable // '409': +// schema: +// "$ref": "#/definitions/error" // description: "Conflict: desired email address already in use" // '500': +// schema: +// "$ref": "#/definitions/error" // description: internal error func (m *Module) EmailChangePOSTHandler(c *gin.Context) { authed, errWithCode := apiutil.TokenAuth(c, diff --git a/internal/api/client/user/passwordchange.go b/internal/api/client/user/passwordchange.go index caa90583f..dc2443b73 100644 --- a/internal/api/client/user/passwordchange.go +++ b/internal/api/client/user/passwordchange.go @@ -57,16 +57,28 @@ const OIDCPasswordHelp = "password change request cannot be processed by GoToSoc // '200': // description: Change successful // '400': +// schema: +// "$ref": "#/definitions/error" // description: bad request // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '403': +// schema: +// "$ref": "#/definitions/error" // description: forbidden // '406': +// schema: +// "$ref": "#/definitions/error" // description: not acceptable // '422': +// schema: +// "$ref": "#/definitions/error" // description: unprocessable request because instance is running with OIDC backend // '500': +// schema: +// "$ref": "#/definitions/error" // description: internal error func (m *Module) PasswordChangePOSTHandler(c *gin.Context) { authed, errWithCode := apiutil.TokenAuth(c, diff --git a/internal/api/client/user/twofactor.go b/internal/api/client/user/twofactor.go index a359607e4..e97aaeea1 100644 --- a/internal/api/client/user/twofactor.go +++ b/internal/api/client/user/twofactor.go @@ -55,16 +55,28 @@ const OIDCTwoFactorHelp = "two factor authentication request cannot be processed // '200': // description: QR code png // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '403': +// schema: +// "$ref": "#/definitions/error" // description: forbidden // '406': +// schema: +// "$ref": "#/definitions/error" // description: not acceptable // '409': +// schema: +// "$ref": "#/definitions/error" // description: conflict // '422': +// schema: +// "$ref": "#/definitions/error" // description: unprocessable entity // '500': +// schema: +// "$ref": "#/definitions/error" // description: internal error func (m *Module) TwoFactorQRCodePngGETHandler(c *gin.Context) { authed, errWithCode := apiutil.TokenAuth(c, @@ -134,16 +146,28 @@ func (m *Module) TwoFactorQRCodePngGETHandler(c *gin.Context) { // '200': // description: QR code uri // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '403': +// schema: +// "$ref": "#/definitions/error" // description: forbidden // '406': +// schema: +// "$ref": "#/definitions/error" // description: not acceptable // '409': +// schema: +// "$ref": "#/definitions/error" // description: conflict // '422': +// schema: +// "$ref": "#/definitions/error" // description: unprocessable entity // '500': +// schema: +// "$ref": "#/definitions/error" // description: internal error func (m *Module) TwoFactorQRCodeURIGETHandler(c *gin.Context) { authed, errWithCode := apiutil.TokenAuth(c, @@ -216,16 +240,28 @@ func (m *Module) TwoFactorQRCodeURIGETHandler(c *gin.Context) { // '200': // description: QR code // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '403': +// schema: +// "$ref": "#/definitions/error" // description: forbidden // '406': +// schema: +// "$ref": "#/definitions/error" // description: not acceptable // '409': +// schema: +// "$ref": "#/definitions/error" // description: conflict // '422': +// schema: +// "$ref": "#/definitions/error" // description: unprocessable entity // '500': +// schema: +// "$ref": "#/definitions/error" // description: internal error func (m *Module) TwoFactorEnablePOSTHandler(c *gin.Context) { authed, errWithCode := apiutil.TokenAuth(c, @@ -300,16 +336,28 @@ func (m *Module) TwoFactorEnablePOSTHandler(c *gin.Context) { // '200': // description: QR code // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '403': +// schema: +// "$ref": "#/definitions/error" // description: forbidden // '406': +// schema: +// "$ref": "#/definitions/error" // description: not acceptable // '409': +// schema: +// "$ref": "#/definitions/error" // description: conflict // '422': +// schema: +// "$ref": "#/definitions/error" // description: unprocessable entity // '500': +// schema: +// "$ref": "#/definitions/error" // description: internal error func (m *Module) TwoFactorDisablePOSTHandler(c *gin.Context) { authed, errWithCode := apiutil.TokenAuth(c, diff --git a/internal/api/client/user/userget.go b/internal/api/client/user/userget.go index ff92815b6..ec9a13450 100644 --- a/internal/api/client/user/userget.go +++ b/internal/api/client/user/userget.go @@ -46,14 +46,24 @@ import ( // schema: // "$ref": "#/definitions/user" // '400': +// schema: +// "$ref": "#/definitions/error" // description: bad request // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '403': +// schema: +// "$ref": "#/definitions/error" // description: forbidden // '406': +// schema: +// "$ref": "#/definitions/error" // description: not acceptable // '500': +// schema: +// "$ref": "#/definitions/error" // description: internal error func (m *Module) UserGETHandler(c *gin.Context) { authed, errWithCode := apiutil.TokenAuth(c, diff --git a/internal/api/model/application.go b/internal/api/model/application.go index 3f974683f..e43c2edb3 100644 --- a/internal/api/model/application.go +++ b/internal/api/model/application.go @@ -37,7 +37,7 @@ type Application struct { // example: https://example.org/callback?some=query RedirectURI string `json:"redirect_uri,omitempty"` // Post-authorization redirect URIs for the application (OAuth2). - // example: [https://example.org/callback?some=query] + // example: ["https://example.org/callback?some=query"] RedirectURIs []string `json:"redirect_uris,omitempty"` // Client ID associated with this application. ClientID string `json:"client_id,omitempty"` diff --git a/internal/api/model/error.go b/internal/api/model/error.go new file mode 100644 index 000000000..6ec073790 --- /dev/null +++ b/internal/api/model/error.go @@ -0,0 +1,32 @@ +// GoToSocial +// Copyright (C) GoToSocial Authors admin@gotosocial.org +// SPDX-License-Identifier: AGPL-3.0-or-later +// +// This program is free software: you can redistribute it and/or modify +// it under the terms of the GNU Affero General Public License as published by +// the Free Software Foundation, either version 3 of the License, or +// (at your option) any later version. +// +// This program is distributed in the hope that it will be useful, +// but WITHOUT ANY WARRANTY; without even the implied warranty of +// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the +// GNU Affero General Public License for more details. +// +// You should have received a copy of the GNU Affero General Public License +// along with this program. If not, see <http://www.gnu.org/licenses/>. + +package model + +// Error is a generic public-facing API error. +// +// swagger:model error +type Error struct { + // Error is usually a human-readable description of the error. + // + // For OAuth-related errors, it will be one of the codes listed in + // <https://datatracker.ietf.org/doc/html/rfc6749#section-5.2>. + Error string `json:"error"` + + // ErrorDescription is only used for OAuth errors, and is a human-readable description of the error. + ErrorDescription string `json:"error_description,omitempty"` +} diff --git a/internal/api/util/errorhandling.go b/internal/api/util/errorhandling.go index 7ffbbbf88..f2f4d94a7 100644 --- a/internal/api/util/errorhandling.go +++ b/internal/api/util/errorhandling.go @@ -43,7 +43,7 @@ import ( // If an error is returned by InstanceGet, the function will panic. func NotFoundHandler(c *gin.Context, instanceGet func(ctx context.Context) (*apimodel.InstanceV1, gtserror.WithCode), accept string, errWithCode gtserror.WithCode) { switch accept { - case string(TextHTML): + case TextHTML: ctx := c.Request.Context() instance, err := instanceGet(ctx) if err != nil { @@ -55,8 +55,8 @@ func NotFoundHandler(c *gin.Context, instanceGet func(ctx context.Context) (*api gtscontext.RequestID(ctx), ) default: - JSON(c, http.StatusNotFound, map[string]string{ - "error": errWithCode.Safe(), + JSON(c, http.StatusNotFound, apimodel.Error{ + Error: errWithCode.Safe(), }) } } @@ -66,7 +66,7 @@ func NotFoundHandler(c *gin.Context, instanceGet func(ctx context.Context) (*api // or just some error json if the caller prefers (or has no preference). func genericErrorHandler(c *gin.Context, instanceGet func(ctx context.Context) (*apimodel.InstanceV1, gtserror.WithCode), accept string, errWithCode gtserror.WithCode) { switch accept { - case string(TextHTML): + case TextHTML: ctx := c.Request.Context() instance, err := instanceGet(ctx) if err != nil { @@ -80,8 +80,8 @@ func genericErrorHandler(c *gin.Context, instanceGet func(ctx context.Context) ( gtscontext.RequestID(ctx), ) default: - JSON(c, errWithCode.Code(), map[string]string{ - "error": errWithCode.Safe(), + JSON(c, errWithCode.Code(), apimodel.Error{ + Error: errWithCode.Safe(), }) } } @@ -179,9 +179,9 @@ func OAuthErrorHandler(c *gin.Context, errWithCode gtserror.WithCode) { l.Debug("handling OAuth error") } - JSON(c, statusCode, map[string]string{ - "error": errWithCode.Error(), - "error_description": errWithCode.Safe(), + JSON(c, statusCode, apimodel.Error{ + Error: errWithCode.Error(), + ErrorDescription: errWithCode.Safe(), }) } @@ -189,8 +189,8 @@ func OAuthErrorHandler(c *gin.Context, errWithCode gtserror.WithCode) { // Specifically used for accounts trying to access endpoints they cannot use while moving. func NotFoundAfterMove(c *gin.Context) { const errMsg = "your account has Moved or is currently Moving; you cannot use this endpoint" - JSON(c, http.StatusForbidden, map[string]string{ - "error": errMsg, + JSON(c, http.StatusForbidden, apimodel.Error{ + Error: errMsg, }) } @@ -198,7 +198,7 @@ func NotFoundAfterMove(c *gin.Context) { // Specifically used for accounts trying to take actions on endpoints they cannot do while moving. func ForbiddenAfterMove(c *gin.Context) { const errMsg = "your account has Moved or is currently Moving; you cannot take create or update type actions" - JSON(c, http.StatusForbidden, map[string]string{ - "error": errMsg, + JSON(c, http.StatusForbidden, apimodel.Error{ + Error: errMsg, }) } |