Get a plugin's JSON Schema (alternative path)
GET /apisix/admin/schema/plugins/{plugin_name}
GET /apisix/admin/schema/plugins/{plugin_name}Interactive request editor loads with JavaScript.
X-API-KEY<token>
Admin API key configured in config.yaml under deployment.admin.admin_key. You can also pass the key as a query parameter api_key or cookie x_api_key.
In: header
Path Parameters
plugin_name*string
Plugin name.
Length
1 <= lengthResponse Body
application/json
application/json
application/json
curl -X GET "http://127.0.0.1:9180/apisix/admin/schema/plugins/limit-count"Plugin JSON Schema.
{}**Bad Request** — The request body is invalid or missing required fields.
{
"error_msg": "invalid configuration: property \"uri\" is required"
}{
"error_msg": "invalid request body: unexpected character at line 1 column 2"
}**Unauthorized** — The API key is missing, invalid, or lacks permission.
{
"error_msg": "failed to check token",
"description": "missing apikey"
}{
"error_msg": "failed to check token",
"description": "wrong apikey"
}{
"error_msg": "failed to check token",
"description": "invalid method for role viewer"
}Complete operation details and schema variants
GET /apisix/admin/schema/plugins/{plugin_name}
Get a plugin's JSON Schema (alternative path)
Equivalent to GET /apisix/admin/plugins/{plugin_name}. Provided for symmetry with GET /apisix/admin/schema/{resource}.
Parameters
plugin_name(path, string, required): Plugin name.
Responses
200: Plugin JSON Schema.400: Bad Request — The request body is invalid or missing required fields.error_msg(string, required): Human-readable error message describing what went wrong.401: Unauthorized — The API key is missing, invalid, or lacks permission.error_msg(string, required): Authentication error message.description(string, optional): Detailed reason for the authentication failure.
cURL
curl -X GET 'http://127.0.0.1:9180/apisix/admin/schema/plugins/{plugin_name}'