snapshot of https://github.com/go-gitea/gitea.git (main, 2026-09-15; blobs > 131072B omitted)

templates/swagger/openapi-viewer.tmpl

@@ -0,0 +1,21 @@
+<!DOCTYPE html>
+<html lang="en">
+	<head>
+		{{ctx.HeadMetaContentSecurityPolicy}}
+		<title>Gitea API</title>
+		<link rel="stylesheet" href="{{ctx.CurrentWebTheme.PublicAssetURI}}">
+		{{/* HINT: SWAGGER-CSS-IMPORT: load swagger styles ahead to avoid flicker (e.g. the swagger-page-links) */}}
+		{{AssetCSSLinks "web_src/js/swagger.ts" "web_src/css/swagger-standalone.css"}}
+	</head>
+	<body>
+		{{/* TODO: add Help & Glossary to help users understand the API, and explain some concepts like "Owner" */}}
+		<div class="swagger-page-links">
+			<a href="{{AppSubUrl}}/openapi3.v1.json" target="_blank">{{svg "octicon-file-code"}}OpenAPI JSON</a>
+			<a href="{{AppSubUrl}}/swagger.v1.json" target="_blank">{{svg "octicon-file-code"}}Swagger JSON</a>
+			<a href="{{AppSubUrl}}/">{{svg "octicon-reply"}}{{ctx.Locale.Tr "return_to_gitea"}}</a>
+		</div>
+		<div id="swagger-ui" data-source="{{AppSubUrl}}/openapi3.v1.json"></div>
+		<footer class="page-footer"></footer>
+		{{ctx.ScriptImport "web_src/js/swagger.ts" "module"}}
+	</body>
+</html>

templates/swagger/v1-input.json

@@ -0,0 +1,17 @@
+{
+  "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"}
+  ]
+}