mediaget.go (2913B)
1 // GoToSocial 2 // Copyright (C) GoToSocial Authors admin@gotosocial.org 3 // SPDX-License-Identifier: AGPL-3.0-or-later 4 // 5 // This program is free software: you can redistribute it and/or modify 6 // it under the terms of the GNU Affero General Public License as published by 7 // the Free Software Foundation, either version 3 of the License, or 8 // (at your option) any later version. 9 // 10 // This program is distributed in the hope that it will be useful, 11 // but WITHOUT ANY WARRANTY; without even the implied warranty of 12 // MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the 13 // GNU Affero General Public License for more details. 14 // 15 // You should have received a copy of the GNU Affero General Public License 16 // along with this program. If not, see <http://www.gnu.org/licenses/>. 17 18 package media 19 20 import ( 21 "errors" 22 "net/http" 23 24 "github.com/gin-gonic/gin" 25 apiutil "github.com/superseriousbusiness/gotosocial/internal/api/util" 26 "github.com/superseriousbusiness/gotosocial/internal/gtserror" 27 "github.com/superseriousbusiness/gotosocial/internal/oauth" 28 ) 29 30 // MediaGETHandler swagger:operation GET /api/v1/media/{id} mediaGet 31 // 32 // Get a media attachment that you own. 33 // 34 // --- 35 // tags: 36 // - media 37 // 38 // produces: 39 // - application/json 40 // 41 // parameters: 42 // - 43 // name: id 44 // description: id of the attachment 45 // type: string 46 // in: path 47 // required: true 48 // 49 // security: 50 // - OAuth2 Bearer: 51 // - read:media 52 // 53 // responses: 54 // '200': 55 // description: The requested media attachment. 56 // schema: 57 // "$ref": "#/definitions/attachment" 58 // '400': 59 // description: bad request 60 // '401': 61 // description: unauthorized 62 // '404': 63 // description: not found 64 // '406': 65 // description: not acceptable 66 // '500': 67 // description: internal server error 68 func (m *Module) MediaGETHandler(c *gin.Context) { 69 if apiVersion := c.Param(APIVersionKey); apiVersion != APIv1 { 70 err := errors.New("api version must be one v1 for this path") 71 apiutil.ErrorHandler(c, gtserror.NewErrorNotFound(err, err.Error()), m.processor.InstanceGetV1) 72 return 73 } 74 75 authed, err := oauth.Authed(c, true, true, true, true) 76 if err != nil { 77 apiutil.ErrorHandler(c, gtserror.NewErrorUnauthorized(err, err.Error()), m.processor.InstanceGetV1) 78 return 79 } 80 81 if _, err := apiutil.NegotiateAccept(c, apiutil.JSONAcceptHeaders...); err != nil { 82 apiutil.ErrorHandler(c, gtserror.NewErrorNotAcceptable(err, err.Error()), m.processor.InstanceGetV1) 83 return 84 } 85 86 attachmentID := c.Param(IDKey) 87 if attachmentID == "" { 88 err := errors.New("no attachment id specified") 89 apiutil.ErrorHandler(c, gtserror.NewErrorBadRequest(err, err.Error()), m.processor.InstanceGetV1) 90 return 91 } 92 93 attachment, errWithCode := m.processor.Media().Get(c.Request.Context(), authed.Account, attachmentID) 94 if errWithCode != nil { 95 apiutil.ErrorHandler(c, errWithCode, m.processor.InstanceGetV1) 96 return 97 } 98 99 c.JSON(http.StatusOK, attachment) 100 }