Clarify that ENABLE_SWAGGER
only influences the API docs, not the routes (#21215)
Previously, the docs seemed to suggest that you can disable the API completely by setting `ENABLE_SWAGGER=false`. This is not the case.
This commit is contained in:
parent
d0e3c53815
commit
0c51595eed
@ -2153,7 +2153,7 @@ ROUTER = console
|
|||||||
;[api]
|
;[api]
|
||||||
;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
|
;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
|
||||||
;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
|
;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
|
||||||
;; Enables Swagger. True or false; default is true.
|
;; Enables the API documentation endpoints (/api/swagger, /api/v1/swagger, …). True or false.
|
||||||
;ENABLE_SWAGGER = true
|
;ENABLE_SWAGGER = true
|
||||||
;; Max number of items in a page
|
;; Max number of items in a page
|
||||||
;MAX_RESPONSE_ITEMS = 50
|
;MAX_RESPONSE_ITEMS = 50
|
||||||
@ -2161,7 +2161,7 @@ ROUTER = console
|
|||||||
;DEFAULT_PAGING_NUM = 30
|
;DEFAULT_PAGING_NUM = 30
|
||||||
;; Default and maximum number of items per page for git trees api
|
;; Default and maximum number of items per page for git trees api
|
||||||
;DEFAULT_GIT_TREES_PER_PAGE = 1000
|
;DEFAULT_GIT_TREES_PER_PAGE = 1000
|
||||||
;; Default size of a blob returned by the blobs API (default is 10MiB)
|
;; Default max size of a blob returned by the blobs API (default is 10MiB)
|
||||||
;DEFAULT_MAX_BLOB_SIZE = 10485760
|
;DEFAULT_MAX_BLOB_SIZE = 10485760
|
||||||
|
|
||||||
;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
|
;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
|
||||||
|
@ -1015,11 +1015,11 @@ Default templates for project boards:
|
|||||||
|
|
||||||
## API (`api`)
|
## API (`api`)
|
||||||
|
|
||||||
- `ENABLE_SWAGGER`: **true**: Enables /api/swagger, /api/v1/swagger etc. endpoints. True or false; default is true.
|
- `ENABLE_SWAGGER`: **true**: Enables the API documentation endpoints (`/api/swagger`, `/api/v1/swagger`, …). True or false.
|
||||||
- `MAX_RESPONSE_ITEMS`: **50**: Max number of items in a page.
|
- `MAX_RESPONSE_ITEMS`: **50**: Max number of items in a page.
|
||||||
- `DEFAULT_PAGING_NUM`: **30**: Default paging number of API.
|
- `DEFAULT_PAGING_NUM`: **30**: Default paging number of API.
|
||||||
- `DEFAULT_GIT_TREES_PER_PAGE`: **1000**: Default and maximum number of items per page for Git trees API.
|
- `DEFAULT_GIT_TREES_PER_PAGE`: **1000**: Default and maximum number of items per page for Git trees API.
|
||||||
- `DEFAULT_MAX_BLOB_SIZE`: **10485760**: Default max size of a blob that can be return by the blobs API.
|
- `DEFAULT_MAX_BLOB_SIZE`: **10485760** (10MiB): Default max size of a blob that can be returned by the blobs API.
|
||||||
|
|
||||||
## OAuth2 (`oauth2`)
|
## OAuth2 (`oauth2`)
|
||||||
|
|
||||||
|
@ -299,7 +299,7 @@ test01.xls: application/vnd.ms-excel; charset=binary
|
|||||||
|
|
||||||
## API (`api`)
|
## API (`api`)
|
||||||
|
|
||||||
- `ENABLE_SWAGGER`: **true**: 是否启用swagger路由 /api/swagger, /api/v1/swagger etc. endpoints. True 或 false; 默认是 true.
|
- `ENABLE_SWAGGER`: **true**: 是否启用swagger路由 /api/swagger, /api/v1/swagger etc. endpoints. True 或 false.
|
||||||
- `MAX_RESPONSE_ITEMS`: **50**: 一个页面最大的项目数。
|
- `MAX_RESPONSE_ITEMS`: **50**: 一个页面最大的项目数。
|
||||||
- `DEFAULT_PAGING_NUM`: **30**: API中默认分页条数。
|
- `DEFAULT_PAGING_NUM`: **30**: API中默认分页条数。
|
||||||
- `DEFAULT_GIT_TREES_PER_PAGE`: **1000**: GIT TREES API每页的默认最大项数.
|
- `DEFAULT_GIT_TREES_PER_PAGE`: **1000**: GIT TREES API每页的默认最大项数.
|
||||||
|
@ -126,13 +126,13 @@ A "login prohibited" user is a user that is not allowed to log in to Gitea anymo
|
|||||||
|
|
||||||
## What is Swagger?
|
## What is Swagger?
|
||||||
|
|
||||||
[Swagger](https://swagger.io/) is what Gitea uses for its API.
|
[Swagger](https://swagger.io/) is what Gitea uses for its API documentation.
|
||||||
|
|
||||||
All Gitea instances have the built-in API, though it can be disabled by setting `ENABLE_SWAGGER` to `false` in the `api` section of your `app.ini`
|
All Gitea instances have the built-in API and there is no way to disable it completely.
|
||||||
|
You can, however, disable showing its documentation by setting `ENABLE_SWAGGER` to `false` in the `api` section of your `app.ini`.
|
||||||
|
For more information, refer to Gitea's [API docs]({{< relref "doc/developers/api-usage.en-us.md" >}}).
|
||||||
|
|
||||||
For more information, refer to Gitea's [API docs]({{< relref "doc/developers/api-usage.en-us.md" >}})
|
You can see the latest API (for example) on <https://try.gitea.io/api/swagger>.
|
||||||
|
|
||||||
[Swagger Example](https://try.gitea.io/api/swagger)
|
|
||||||
|
|
||||||
## Adjusting your server for public/private use
|
## Adjusting your server for public/private use
|
||||||
|
|
||||||
|
Loading…
Reference in New Issue
Block a user