summaryrefslogtreecommitdiff
path: root/docs/api
diff options
context:
space:
mode:
authorLibravatar tobi <31960611+tsmethurst@users.noreply.github.com>2025-02-04 16:52:42 +0100
committerLibravatar GitHub <noreply@github.com>2025-02-04 16:52:42 +0100
commit07d27709957248008c61d6b8d553e3d2eb14d154 (patch)
treed054e92729708e275886100492a458d633fbaa59 /docs/api
parentadds support for build specifically without wasm ffmpeg (#3732) (diff)
downloadgotosocial-07d27709957248008c61d6b8d553e3d2eb14d154.tar.xz
[feature] Change `instance-stats-randomize` to `instance-stats-mode` with multiple options; implement nodeinfo 2.1 (#3734)
* [feature] Change `instance-stats-randomize` to `instance-stats-mode` with multiple options; implement nodeinfo 2.1 * swaggalaggadingdong
Diffstat (limited to 'docs/api')
-rw-r--r--docs/api/swagger.yaml31
1 files changed, 30 insertions, 1 deletions
diff --git a/docs/api/swagger.yaml b/docs/api/swagger.yaml
index 65d332227..ed44a5561 100644
--- a/docs/api/swagger.yaml
+++ b/docs/api/swagger.yaml
@@ -77,10 +77,20 @@ definitions:
x-go-package: github.com/superseriousbusiness/gotosocial/internal/api/model
NodeInfoSoftware:
properties:
+ homepage:
+ description: Homepage for the software. Omitted in version 2.0.
+ example: https://docs.gotosocial.org
+ type: string
+ x-go-name: Homepage
name:
example: gotosocial
type: string
x-go-name: Name
+ repository:
+ description: Repository for the software. Omitted in version 2.0.
+ example: https://codeberg.org/superseriousbusiness/gotosocial
+ type: string
+ x-go-name: Repository
version:
example: 0.1.2 1234567
type: string
@@ -90,6 +100,10 @@ definitions:
x-go-package: github.com/superseriousbusiness/gotosocial/internal/api/model
NodeInfoUsage:
properties:
+ localComments:
+ format: int64
+ type: integer
+ x-go-name: LocalComments
localPosts:
format: int64
type: integer
@@ -101,6 +115,14 @@ definitions:
x-go-package: github.com/superseriousbusiness/gotosocial/internal/api/model
NodeInfoUsers:
properties:
+ activeHalfYear:
+ format: int64
+ type: integer
+ x-go-name: ActiveHalfYear
+ activeMonth:
+ format: int64
+ type: integer
+ x-go-name: ActiveMonth
total:
format: int64
type: integer
@@ -12504,12 +12526,19 @@ paths:
summary: Returns code 200 if GoToSocial is "live", ie., able to respond to HTTP requests.
tags:
- health
- /nodeinfo/2.0:
+ /nodeinfo/{schema_version}:
get:
description: 'See: https://nodeinfo.diaspora.software/schema.html'
operationId: nodeInfoGet
+ parameters:
+ - description: Schema version of nodeinfo to request. 2.0 and 2.1 are currently supported.
+ in: path
+ name: schema_version
+ required: true
+ type: string
produces:
- application/json; profile="http://nodeinfo.diaspora.software/ns/schema/2.0#"
+ - application/json; profile="http://nodeinfo.diaspora.software/ns/schema/2.1#"
responses:
"200":
description: ""