hyperzlib
/
nodebb
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

fix(openapi): added CategoryObject component

Browse Source
v1.18.x
Julian Lam 5 years ago
parent 646fac1e53
commit 55d0a9ffea
2 changed files with 357 additions and 580 deletions
Show Stats Download Patch File Download Diff File

65
public/openapi/components/schemas/CategoryObject.yaml
Unescape Escape View File

@ -0,0 +1,65 @@
CategoryObject:
type: object
properties:
cid:
type: number
description: A category identifier assigned upon category creation (this value cannot be changed)
name:
type: string
description: The category's name/title
description:
type: string
description: A variable-length description of the category (usually displayed underneath the category name)
descriptionParsed:
type: string
description: A variable-length description of the category (usually displayed underneath the category name). Unlike `description`, this value here will have been run through any parsers installed on the forum (e.g. Markdown)
icon:
type: string
description: A FontAwesome icon string
example: fa-comments-o
bgColor:
type: string
description: Theme-related, a six-character hexadecimal string representing the background colour of the category
color:
type: string
description: Theme-related, a six-character hexadecimal string representing the foreground/text colour of the category
slug:
type: string
description: An URL-safe variant of the category title. This value is automatically generated.
readOnly: true
parentCid:
type: number
description: The category identifier for the category that is the immediate ancestor of the current category
topic_count:
type: number
description: The number of topics in the category
post_count:
type: number
description: The number of posts in the category
disabled:
type: number
description: Whether or not this category is disabled.
order:
type: number
description: A number representing the category's place in the hierarchy
link:
type: string
description: If set, attempting to access the forum will go to this external link instead (theme-specific)
numRecentReplies:
type: number
description: The number of posts to render in the API response (this is mostly used at the theme level)
class:
type: string
description: Values that are appended to the `class` attribute of the category's parent/root element
imageClass:
type: string
enum: [auto, cover, contain]
description: The `background-position` of the category background image, if one is set
isSection:
type: number
totalPostCount:
type: number
description: The number of posts in the category
totalTopicCount:
type: number
description: The number of topics in the category

312
public/openapi/read.yaml
Unescape Escape View File

@ -61,108 +61,17 @@ paths:
categories:
type: array
items:
type: object
allOf:
- $ref: components/schemas/CategoryObject.yaml#/CategoryObject
- type: object
properties:
cid:
type: number
description: A category identifier
name:
type: string
description:
type: string
icon:
type: string
slug:
type: string
topic_count:
type: number
description: The number of topics in the category
order:
type: number
bgColor:
type: string
link:
type: string
class:
type: string
numRecentReplies:
type: number
color:
type: string
post_count:
type: number
description: The number of posts in the category
descriptionParsed:
type: string
parentCid:
type: number
description: The category identifier for the category that is the immediate
ancestor of the current category
disabled:
type: number
isSection:
type: number
totalPostCount:
type: number
description: The number of posts in the category
totalTopicCount:
type: number
description: The number of topics in the category
tagWhitelist:
type: array
items: {}
unread-class:
type: string
children:
type: array
items:
type: object
allOf:
- $ref: components/schemas/CategoryObject.yaml#/CategoryObject
- type: object
properties:
cid:
type: number
description: A category identifier
name:
type: string
description:
type: string
icon:
type: string
slug:
type: string
topic_count:
type: number
description: The number of topics in the category
order:
type: number
bgColor:
type: string
link:
type: string
class:
type: string
numRecentReplies:
type: number
color:
type: string
post_count:
type: number
description: The number of posts in the category
parentCid:
type: number
description: The category identifier for the category that is the immediate
ancestor of the current category
disabled:
type: number
isSection:
type: number
totalPostCount:
type: number
description: The number of posts in the category
totalTopicCount:
type: number
description: The number of topics in the category
descriptionParsed:
type: string
tagWhitelist:
type: array
items: {}
@ -172,60 +81,7 @@ paths:
type: array
items: {}
parent:
type: object
properties:
link:
type: string
class:
type: string
icon:
type: string
description:
type: string
order:
type: number
topic_count:
type: number
description: The number of topics in the category
name:
type: string
cid:
type: number
description: A category identifier
post_count:
type: number
description: The number of posts in the category
numRecentReplies:
type: number
bgColor:
type: string
slug:
type: string
color:
type: string
disabled:
type: number
descriptionParsed:
type: string
isSection:
type: number
parentCid:
type: number
description: The category identifier for the category that is the immediate
ancestor of the current category
totalPostCount:
type: number
description: The number of posts in the category
totalTopicCount:
type: number
description: The number of topics in the category
tagWhitelist:
type: array
items: {}
unread-class:
type: string
imageClass:
type: string
$ref: components/schemas/CategoryObject.yaml#/CategoryObject
posts:
type: array
items:
@ -363,8 +219,6 @@ paths:
type: string
title:
type: string
imageClass:
type: string
topics:
type: array
items:
@ -3832,6 +3686,7 @@ paths:
application/json:
schema:
allOf:
- $ref: components/schemas/CategoryObject.yaml#/CategoryObject
- type: object
properties:
tid:
@ -4041,54 +3896,6 @@ paths:
type: boolean
display_post_menu:
type: boolean
category:
type: object
properties:
link:
type: string
class:
type: string
icon:
type: string
description:
type: string
order:
type: number
topic_count:
type: number
description: The number of topics in the category
name:
type: string
cid:
type: number
description: A category identifier
post_count:
type: number
description: The number of posts in the category
numRecentReplies:
type: number
bgColor:
type: string
slug:
type: string
color:
type: string
disabled:
type: number
descriptionParsed:
type: string
isSection:
type: number
parentCid:
type: number
description: The category identifier for the category that is the immediate
ancestor of the current category
totalPostCount:
type: number
description: The number of posts in the category
totalTopicCount:
type: number
description: The number of topics in the category
tagWhitelist:
type: array
items: {}
@ -4226,6 +4033,7 @@ paths:
application/json:
schema:
allOf:
- $ref: components/schemas/CategoryObject.yaml#/CategoryObject
- type: object
properties:
tid:
@ -4491,54 +4299,6 @@ paths:
username:
type: string
description: A friendly name for a given user account
category:
type: object
properties:
link:
type: string
class:
type: string
icon:
type: string
description:
type: string
order:
type: number
topic_count:
type: number
description: The number of topics in the category
name:
type: string
cid:
type: number
description: A category identifier
post_count:
type: number
description: The number of posts in the category
numRecentReplies:
type: number
bgColor:
type: string
slug:
type: string
color:
type: string
disabled:
type: number
descriptionParsed:
type: string
isSection:
type: number
parentCid:
type: number
description: The category identifier for the category that is the immediate
ancestor of the current category
totalPostCount:
type: number
description: The number of posts in the category
totalTopicCount:
type: number
description: The number of topics in the category
tagWhitelist:
type: array
items: {}
@ -4988,7 +4748,8 @@ paths:
posts:
type: array
items:
type: object
allOf:
- type: object
properties:
id:
type: string
@ -5118,56 +4879,7 @@ paths:
type: string
titleRaw:
type: string
category:
type: object
properties:
cid:
type: number
description: A category identifier
name:
type: string
description:
type: string
icon:
type: string
bgColor:
type: string
color:
type: string
slug:
type: string
parentCid:
type: number
description: The category identifier for the category that is the immediate
ancestor of the current category
topic_count:
type: number
description: The number of topics in the category
post_count:
type: number
description: The number of posts in the category
disabled:
type: number
order:
type: number
link:
type: string
numRecentReplies:
type: number
class:
type: string
imageClass:
type: string
descriptionParsed:
type: string
isSection:
type: number
totalPostCount:
type: number
description: The number of posts in the category
totalTopicCount:
type: number
description: The number of topics in the category
- $ref: components/schemas/CategoryObject.yaml#/CategoryObject
- $ref: components/schemas/Pagination.yaml#/Pagination
- $ref: components/schemas/CommonProps.yaml#/CommonProps
/api/ip-blacklist:

Write Preview
Loading…
Cancel
Save