feat(api): closes #9123 category and topic routes migrated to Write API

public/openapi/components/schemas/CategoryObject.yaml

@@ -1,5 +1,6 @@
 CategoryObject:
-  type: object
+  allOf:
+    - type: object
       properties:
         cid:
           type: number
@@ -71,3 +72,14 @@ CategoryObject:
         totalTopicCount:
           type: number
           description: The number of topics in the category
+    - type: object
+      description: Optional properties that may or may not be present (except for `cid`, which is always present, and is only here as a hack to pass validation)
+      properties:
+        cid:
+          type: number
+          description: A category identifier
+        backgroundImage:
+          type: string
+          description: Relative URL to the category's background image
+      required:
+        - cid

public/openapi/components/schemas/TopicObject.yaml

@@ -3,19 +3,8 @@ TopicObject:
     - $ref: '#/TopicObjectSlim'
     - type: object
       properties:
-        title:
-          type: string
-        slug:
-          type: string
         lastposttime:
           type: number
-        teaserPid:
-          oneOf:
-            - type: number
-            - type: string
-          nullable: true
-        titleRaw:
-          type: string
         thumbs:
           type: array
           items:
@@ -218,6 +207,10 @@ TopicObjectSlim:
     cid:
       type: number
       description: A category identifier
+    title:
+      type: string
+    slug:
+      type: string
     mainPid:
       type: number
       description: The post id of the first post in this topic (also called the "original post")
@@ -231,6 +224,8 @@ TopicObjectSlim:
       type: number
     deleterUid:
       type: number
+    titleRaw:
+      type: string
     locked:
       type: number
     pinned:
@@ -259,3 +254,8 @@ TopicObjectSlim:
       type: number
     votes:
       type: number
+    teaserPid:
+      oneOf:
+        - type: number
+        - type: string
+      nullable: true

public/openapi/write/categories/cid.yaml

@@ -1,6 +1,31 @@
+get:
+  tags:
+    - categories
+  summary: get a category
+  description: This operation retrieves a category's data
+  parameters:
+    - in: path
+      name: cid
+      schema:
+        type: string
+      required: true
+      description: a valid category id
+      example: 2
+  responses:
+    '200':
+      description: Category successfully retrieved
+      content:
+        application/json:
+          schema:
+            type: object
+            properties:
+              status:
+                $ref: ../../components/schemas/Status.yaml#/Status
+              response:
+                $ref: ../../components/schemas/CategoryObject.yaml#/CategoryObject
 put:
   tags:
-    - topics
+    - categories
   summary: update a category
   description: This operation updates an existing category.
   parameters:
@@ -42,7 +67,7 @@ put:
                         type: string
 delete:
   tags:
-    - topics
+    - categories
   summary: delete a category
   description: This operation deletes and purges a category and all of its topics and posts (careful, there is no confirmation!)
   parameters:

public/openapi/write/posts/pid.yaml

@@ -1,3 +1,69 @@
+get:
+  tags:
+    - posts
+  summary: get a post
+  description: This operation retrieves a post's data
+  parameters:
+    - in: path
+      name: pid
+      schema:
+        type: string
+      required: true
+      description: a valid post id
+      example: 1
+  responses:
+    '200':
+      description: Post successfully retrieved
+      content:
+        application/json:
+          schema:
+            type: object
+            properties:
+              status:
+                $ref: ../../components/schemas/Status.yaml#/Status
+              response:
+                type: object
+                properties:
+                  pid:
+                    type: number
+                  uid:
+                    type: number
+                    description: A user identifier
+                  tid:
+                    type: number
+                    description: A topic identifier
+                  content:
+                    type: string
+                  timestamp:
+                    type: number
+                  flagId:
+                    type: number
+                  deleted:
+                    type: number
+                  upvotes:
+                    type: number
+                  downvotes:
+                    type: number
+                  deleterUid:
+                    type: number
+                  edited:
+                    type: number
+                  replies:
+                    type: number
+                  bookmarks:
+                    type: number
+                  votes:
+                    type: number
+                  timestampISO:
+                    type: string
+                    description: An ISO 8601 formatted date string (complementing `timestamp`)
+                  editedISO:
+                    type: string
+                    description: An ISO 8601 formatted date string (complementing `timestamp`)
+                  upvoted:
+                    type: boolean
+                  downvoted:
+                    type: boolean
 put:
   tags:
     - posts

public/openapi/write/topics/tid.yaml

@@ -1,3 +1,28 @@
+get:
+  tags:
+    - topics
+  summary: get a topic
+  description: This operation retrieves a topic's data
+  parameters:
+    - in: path
+      name: tid
+      schema:
+        type: string
+      required: true
+      description: a valid topic id
+      example: 1
+  responses:
+    '200':
+      description: Topic successfully retrieved
+      content:
+        application/json:
+          schema:
+            type: object
+            properties:
+              status:
+                $ref: ../../components/schemas/Status.yaml#/Status
+              response:
+                $ref: ../../components/schemas/TopicObject.yaml#/TopicObjectSlim
 post:
   tags:
     - topics

src/controllers/write/categories.js

@@ -15,6 +15,10 @@ const hasAdminPrivilege = async (uid) => {
 	}
 };
 
+Categories.get = async (req, res) => {
+	helpers.formatApiResponse(200, res, await api.categories.get(req, req.params));
+};
+
 Categories.create = async (req, res) => {
 	await hasAdminPrivilege(req.uid);
 

src/controllers/write/topics.js

@@ -12,6 +12,10 @@ const uploadsController = require('../uploads');
 
 const Topics = module.exports;
 
+Topics.get = async (req, res) => {
+	helpers.formatApiResponse(200, res, await api.topics.get(req, req.params));
+};
+
 Topics.create = async (req, res) => {
 	const payload = await api.topics.create(req, req.body);
 	if (payload.queued) {

src/routes/write/categories.js

@@ -11,6 +11,7 @@ module.exports = function () {
 	const middlewares = [middleware.authenticate];
 
 	setupApiRoute(router, 'post', '/', [...middlewares, middleware.checkRequired.bind(null, ['name'])], controllers.write.categories.create);
+	setupApiRoute(router, 'get', '/:cid', [middleware.authenticateOrGuest], controllers.write.categories.get);
 	setupApiRoute(router, 'put', '/:cid', [...middlewares], controllers.write.categories.update);
 	setupApiRoute(router, 'delete', '/:cid', [...middlewares], controllers.write.categories.delete);
 

src/routes/write/topics.js

@@ -14,6 +14,7 @@ module.exports = function () {
 	var multipartMiddleware = multipart();
 
 	setupApiRoute(router, 'post', '/', [middleware.authenticateOrGuest, middleware.checkRequired.bind(null, ['cid', 'title', 'content'])], controllers.write.topics.create);
+	setupApiRoute(router, 'get', '/:tid', [middleware.authenticateOrGuest], controllers.write.topics.get);
 	setupApiRoute(router, 'post', '/:tid', [middleware.authenticateOrGuest, middleware.checkRequired.bind(null, ['content']), middleware.assert.topic], controllers.write.topics.reply);
 	setupApiRoute(router, 'delete', '/:tid', [...middlewares], controllers.write.topics.purge);