Plugins API
Plugins can be accessed through this API using GET. This service retrieves information about plugins.
Authentication - Use Basic Authentication for this API.
GET
GET (Using Query Parameters)
This GET service will return a list of plugins in the form of JSON objects based on a query parameter for the display name. Plugins are only returned if they contain the specified parameter. If no query parameters are given this request will return the entire list of plugins. Plugins are returned in descending order by Install Date.
API URL
http://host:port/flexdeploy/rest/v1/administration/plugins
Append the following character sequences to the above URL to specify Query parameters.
?pluginDisplayName={pluginDisplayName}
Examples:
To return all of the plugins:
http://host:port/flexdeploy/rest/v1/administration/plugins
To search by display name only:
http://host:port/flexdeploy/rest/v1/administration/plugins?pluginDisplayName={pluginDisplayName}
The query parameters are not case sensitive. Searching by name=EXAMPLE is the same as searching by name=example.
Request
Parameter | Type | Required | Description |
---|---|---|---|
pluginDisplayName | Query - String | No | This is a URL query parameter for the display name which is used to search the plugins. Contains ignore case type search. |
Response Codes
HTTP Code | Description |
---|---|
200 | Search successful and results returned |
400 | Bad request |
401 | Authentication failure |
403 | Authorization failure (no access to resource) |
500 | Unexpected internal server error |
Example
If we had a plugin in our database with the following attributes
[ { "isActive": true, "pluginId": 10705, "pluginName": "FlexagonJDBCPlugin", "pluginDisplayName": "JDBC", "pluginVersion": "4.5.1.38", "description": "A plugin to import, export, and run scripts.", "vendorName": "Flexagon", "pluginGroup": "Database", "pluginSubGroup": "JDBC", "pluginType": "java", "imageName": null, "isVersionCurrentlyActive": true, "operations": [ { "export", "import", "partialBuild", "partialDeploy", "runPLSQL", "runQuery", "runScript" } ] } ]
When we run a GET request at the following URL
http://host:port/flexdeploy/rest/v1/administration/plugins?pluginDisplayName=JDBC
The GET request would return the following JSON plugin object
[ { "isActive": true, "pluginId": 10705, "pluginName": "FlexagonJDBCPlugin", "pluginDisplayName": "JDBC", "pluginVersion": "4.5.1.38", "description": "A plugin to import, export, and run scripts.", "vendorName": "Flexagon", "pluginGroup": "Database", "pluginSubGroup": "JDBC", "pluginType": "java", "imageName": null, "isVersionCurrentlyActive": true, "operations": [ { "export", "import", "partialBuild", "partialDeploy", "runPLSQL", "runQuery", "runScript" } ] } ]
- style