mirror of
https://github.com/go-gitea/gitea.git
synced 2026-08-01 01:20:17 +00:00
silverwind
f0a95eebe3
The api specs were Go templates whose committed form was not a valid swagger document, so `swagger-validate`, `generate-openapi.go` and `.spectral.yaml` each worked around it. They are now plain json, substituted at serve time. Renaming them off `.tmpl` also stops `make fmt` rewriting them, which used to bump their mtime and silently skip the next `make generate-swagger`. Also enables stricter spectral linting: extends `lint-swagger` to the OpenAPI 3 spec, turns on `openapi-tags`, `operation-singular-tag` and `operation-tag-defined`, adds a top-level `tags` array with descriptions to the swagger input, and drops the redundant `repository` tag from `POST /user/repos`. --------- Signed-off-by: silverwind <me@silverwind.io> Co-authored-by: wxiaoguang <wxiaoguang@gmail.com> Co-authored-by: Giteabot <teabot@gitea.io>
18 lines
757 B
JSON
18 lines
757 B
JSON
{
|
|
"info": {
|
|
"version": "0.0.0+GITEA-API-APP-VERSION"
|
|
},
|
|
"basePath": "/GITEA-API-APP-SUBURL/api/v1",
|
|
"tags": [
|
|
{"name": "admin", "description": "Site administration"},
|
|
{"name": "issue", "description": "Issues, pull requests, comments, labels and milestones"},
|
|
{"name": "miscellaneous", "description": "Miscellaneous endpoints"},
|
|
{"name": "notification", "description": "User notifications"},
|
|
{"name": "organization", "description": "Organizations and teams"},
|
|
{"name": "package", "description": "Package registry"},
|
|
{"name": "repository", "description": "Repositories and their contents"},
|
|
{"name": "settings", "description": "Server settings"},
|
|
{"name": "user", "description": "The authenticated user"}
|
|
]
|
|
}
|