gtsocial-umbx

commit 6a101237902dd9fd7205967dc9e5a95ce8d1b765
parent 2b34a9b51c289619041e40d13571a874d8a2fc49
Author: tobi <31960611+tsmethurst@users.noreply.github.com>
Date:   Tue, 13 Sep 2022 13:30:07 +0200

[docs] Swagger document `/api/v1/custom_emojis` (#824)


Diffstat:
M
docs/api/swagger.yaml
 | 
25
+++++++++++++++++++++++++
M
docs/swagger.go
 | 
1
+
M
internal/api/client/emoji/emojisget.go
 | 
29
++++++++++++++++++++++++++++-

3 files changed, 54 insertions(+), 1 deletion(-)
diff --git a/docs/api/swagger.yaml b/docs/api/swagger.yaml
@@ -3128,6 +3128,30 @@ paths:
       summary: Get an array of accounts that requesting account has blocked.
       tags:
       - blocks
+  /api/v1/custom_emojis:
+    get:
+      operationId: customEmojisGet
+      produces:
+      - application/json
+      responses:
+        "200":
+          description: Array of custom emojis.
+          schema:
+            items:
+              $ref: '#/definitions/emoji'
+            type: array
+        "401":
+          description: unauthorized
+        "406":
+          description: not acceptable
+        "500":
+          description: internal server error
+      security:
+      - OAuth2 Bearer:
+        - read:custom_emojis
+      summary: Get an array of custom emojis available on the instance.
+      tags:
+      - custom_emojis
   /api/v1/follow_requests:
     get:
       description: |-
@@ -4451,6 +4475,7 @@ securityDefinitions:
       read: grants read access to everything
       read:accounts: grants read access to accounts
       read:blocks: grant read access to blocks
+      read:custom_emojis: grant read access to custom_emojis
       read:media: grant read access to media
       read:notifications: grants read access to notifications
       read:search: grant read access to searches
diff --git a/docs/swagger.go b/docs/swagger.go
@@ -36,6 +36,7 @@
 //           read: grants read access to everything
 //           read:accounts: grants read access to accounts
 //           read:blocks: grant read access to blocks
+//           read:custom_emojis: grant read access to custom_emojis
 //           read:media: grant read access to media
 //           read:search: grant read access to searches
 //           read:statuses: grants read access to statuses
diff --git a/internal/api/client/emoji/emojisget.go b/internal/api/client/emoji/emojisget.go
@@ -9,7 +9,34 @@ import (
 	"github.com/superseriousbusiness/gotosocial/internal/oauth"
 )
 
-// EmojisGETHandler returns a list of custom emojis enabled on the instance
+// EmojisGETHandler swagger:operation GET /api/v1/custom_emojis customEmojisGet
+//
+// Get an array of custom emojis available on the instance.
+//
+// ---
+// tags:
+// - custom_emojis
+//
+// produces:
+// - application/json
+//
+// security:
+// - OAuth2 Bearer:
+//   - read:custom_emojis
+//
+// responses:
+//   '200':
+//     description: Array of custom emojis.
+//     schema:
+//       type: array
+//       items:
+//         "$ref": "#/definitions/emoji"
+//   '401':
+//      description: unauthorized
+//   '406':
+//      description: not acceptable
+//   '500':
+//      description: internal server error
 func (m *Module) EmojisGETHandler(c *gin.Context) {
 	if _, err := oauth.Authed(c, true, true, true, true); err != nil {
 		api.ErrorHandler(c, gtserror.NewErrorUnauthorized(err, err.Error()), m.processor.InstanceGet)