listget.go (2635B)
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 lists 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 // ListGETHandler swagger:operation GET /api/v1/lists/{id} list 31 // 32 // Get a single list with the given ID. 33 // 34 // --- 35 // tags: 36 // - lists 37 // 38 // produces: 39 // - application/json 40 // 41 // parameters: 42 // - 43 // name: id 44 // type: string 45 // description: ID of the list 46 // in: path 47 // required: true 48 // 49 // security: 50 // - OAuth2 Bearer: 51 // - read:lists 52 // 53 // responses: 54 // '200': 55 // name: list 56 // description: Requested list. 57 // schema: 58 // "$ref": "#/definitions/list" 59 // '400': 60 // description: bad request 61 // '401': 62 // description: unauthorized 63 // '404': 64 // description: not found 65 // '406': 66 // description: not acceptable 67 // '500': 68 // description: internal server error 69 func (m *Module) ListGETHandler(c *gin.Context) { 70 authed, err := oauth.Authed(c, true, true, true, true) 71 if err != nil { 72 apiutil.ErrorHandler(c, gtserror.NewErrorUnauthorized(err, err.Error()), m.processor.InstanceGetV1) 73 return 74 } 75 76 if _, err := apiutil.NegotiateAccept(c, apiutil.JSONAcceptHeaders...); err != nil { 77 apiutil.ErrorHandler(c, gtserror.NewErrorNotAcceptable(err, err.Error()), m.processor.InstanceGetV1) 78 return 79 } 80 81 targetListID := c.Param(IDKey) 82 if targetListID == "" { 83 err := errors.New("no list id specified") 84 apiutil.ErrorHandler(c, gtserror.NewErrorBadRequest(err, err.Error()), m.processor.InstanceGetV1) 85 return 86 } 87 88 resp, errWithCode := m.processor.List().Get(c.Request.Context(), authed.Account, targetListID) 89 if errWithCode != nil { 90 apiutil.ErrorHandler(c, errWithCode, m.processor.InstanceGetV1) 91 return 92 } 93 94 c.JSON(http.StatusOK, resp) 95 }