API doc of Manager API.

Manager API directly operates ETCD and provides data management for Apache APISIX, provides APIs for Front-end or other clients.

License: Apache License 2.0

/apisix/admin/check_ssl_cert

POST

Summary:

verify SSL cert and key.

Parameters

Name	Located in	Description	Required	Schema
cert	body	cert of SSL	Yes	string
key	body	key of SSL	Yes	string

Responses

Code	Description	Schema
0	SSL verify passed	ApiError
default	unexpected error	ApiError

/apisix/admin/check_ssl_exists

POST

Summary:

Check whether the SSL exists.

Parameters

Name	Located in	Description	Required	Schema
cert	body	cert of SSL	Yes	string
key	body	key of SSL	Yes	string

Responses

Code	Description	Schema
0	SSL exists	ApiError
default	unexpected error	ApiError

/apisix/admin/consumers

GET

Summary:

Return the consumer list according to the specified page number and page size, and can search consumers by username.

Parameters

Name	Located in	Description	Required	Schema
page	query	page number	No	integer
page_size	query	page size	No	integer
username	query	username of consumer	No	string

Responses

Code	Description	Schema
0	list response	[ consumer ]
default	unexpected error	ApiError

/apisix/admin/notexist/routes

GET

Summary:

Return result of route exists checking by name and exclude id.

Parameters

Name	Located in	Description	Required	Schema
name	query	name of route	No	string
exclude	query	id of route that exclude checking	No	string

Responses

Code	Description	Schema
0	route not exists	ApiError
default	unexpected error	ApiError

/apisix/admin/routes

GET

Summary:

Return the route list according to the specified page number and page size, and can search routes by name and uri.

Parameters

Name	Located in	Description	Required	Schema
page	query	page number	No	integer
page_size	query	page size	No	integer
name	query	name of route	No	string
uri	query	uri of route	No	string

Responses

Code	Description	Schema
0	list response	[ route ]
default	unexpected error	ApiError

/apisix/admin/services

GET

Summary:

Return the service list according to the specified page number and page size, and can search services by name.

Parameters

Name	Located in	Description	Required	Schema
page	query	page number	No	integer
page_size	query	page size	No	integer
name	query	name of service	No	string

Responses

Code	Description	Schema
0	list response	[ service ]
default	unexpected error	ApiError

/apisix/admin/ssl

GET

Summary:

Return the SSL list according to the specified page number and page size, and can SSLs search by sni.

Parameters

Name	Located in	Description	Required	Schema
page	query	page number	No	integer
page_size	query	page size	No	integer
sni	query	sni of SSL	No	string

Responses

Code	Description	Schema
0	list response	[ ssl ]
default	unexpected error	ApiError

/apisix/admin/upstreams

GET

Summary:

Return the upstream list according to the specified page number and page size, and can search upstreams by name.

Parameters

Name	Located in	Description	Required	Schema
page	query	page number	No	integer
page_size	query	page size	No	integer
name	query	name of upstream	No	string

Responses

Code	Description	Schema
0	list response	[ upstream ]
default	unexpected error	ApiError

/apisix/admin/user/login

POST

Summary:

user login.

Parameters

Name	Located in	Description	Required	Schema
username	body	user name	Yes	string
password	body	password	Yes	string

Responses

Code	Description	Schema
0	login success	ApiError
default	unexpected error	ApiError

Models

ApiError

Name	Type	Description	Required
code	long	response code	No
message	string	response message	No

BaseInfo

Name	Type	Description	Required
create_time	long		No
id	object		No
update_time	long		No

Consumer

Name	Type	Description	Required
create_time	long		No
desc	string		No
id	object		No
labels	object		No
plugins	object		No
update_time	long		No
username	string		No

LoginInput

Name	Type	Description	Required
password	string	password	No
username	string	user name	No

Route

Name	Type	Description	Required
create_time	long		No
desc	string		No
enable_websocket	boolean		No
filter_func	string		No
host	string		No
hosts	[ string ]		No
id	object		No
labels	object		No
methods	[ string ]		No
name	string		No
plugins	object		No
priority	long		No
remote_addr	string		No
remote_addrs	[ string ]		No
script	object		No
service_id	object		No
service_protocol	string		No
update_time	long		No
upstream	UpstreamDef		No
upstream_id	object		No
uri	string		No
uris	[ string ]		No
vars	object		No

SSL

Name	Type	Description	Required
cert	string		No
certs	[ string ]		No
create_time	long		No
exptime	long		No
id	object		No
key	string		No
keys	[ string ]		No
labels	object		No
sni	string		No
snis	[ string ]		No
status	long		No
update_time	long		No
validity_end	long		No
validity_start	long		No

Service

Name	Type	Description	Required
create_time	long		No
desc	string		No
enable_websocket	boolean		No
id	object		No
labels	object		No
name	string		No
plugins	object		No
script	string		No
update_time	long		No
upstream	UpstreamDef		No
upstream_id	object		No

Upstream

Name	Type	Description	Required
checks	object		No
create_time	long		No
desc	string		No
hash_on	string		No
id	object		No
k8s_deployment_info	object		No
key	string		No
labels	object		No
name	string		No
nodes	object		No
pass_host	string		No
retries	long		No
service_name	string		No
timeout	object		No
type	string		No
update_time	long		No
upstream_host	string		No

UpstreamDef

Name	Type	Description	Required
checks	object		No
desc	string		No
hash_on	string		No
k8s_deployment_info	object		No
key	string		No
labels	object		No
name	string		No
nodes	object		No
pass_host	string		No
retries	long		No
service_name	string		No
timeout	object		No
type	string		No
upstream_host	string		No