1
0
Fork 0
mirror of https://codeberg.org/forgejo/forgejo.git synced 2024-12-24 13:09:23 -05:00
forgejo/routers/api/v1/swagger
techknowlogick babab0bf5e
Add nodeinfo endpoint for federation purposes (#16953)
Nodeinfo is a way to expose certain metadata about a server for use of discovery regarding functionality of its federation capabilities.

Two endpoints are required:
1. `/.well-known/nodeinfo` which informs client where it can find the location of the location of its metadata (including which version of the schema is used)
2. the endpoint which exposes the metadata in json format according to schema.

Notes:
* `openRegistrations` is a required field, but I propose to set to false as default in case someone writes a crawler to discover "open" gitea instances
* to limit data leakage I also propose to not include the `usage` field (note it is required so it should be included, but left as empty).

More info:
https://github.com/jhass/nodeinfo
https://github.com/jhass/nodeinfo/tree/main/schemas/2.1
http://nodeinfo.diaspora.software/protocol.html
2021-09-28 01:38:06 +02:00
..
app.go Swagger AccessToken fixes (#16574) 2021-08-01 16:44:15 -04:00
cron.go Add cron running API (#12421) 2020-08-24 11:48:15 -04:00
issue.go Issue templates directory (#11450) 2020-09-11 10:48:39 -04:00
key.go Move sdk structs to modules/structs (#6905) 2019-05-11 18:21:34 +08:00
misc.go API: Move AllowedReactions endpoint into GetGenneralUI endpoint + creat new swagger section settings (#11854) 2020-06-22 14:21:31 -04:00
nodeinfo.go Add nodeinfo endpoint for federation purposes (#16953) 2021-09-28 01:38:06 +02:00
notify.go [API] add endpoint to check notifications [Extend #9488] (#9595) 2020-01-14 16:37:19 +01:00
options.go Swagger AccessToken fixes (#16574) 2021-08-01 16:44:15 -04:00
org.go Move sdk structs to modules/structs (#6905) 2019-05-11 18:21:34 +08:00
repo.go Add an api endpoint to fetch git notes (#15373) (#16649) 2021-08-11 03:01:40 +02:00
settings.go Expose Attachemnt Settings by API (#12514) 2020-09-05 08:43:06 +01:00
user.go [API] GET / SET User Settings (#16169) 2021-06-23 15:58:44 -04:00