Plugins API - GET an endpoint of a plugin
Lists properties of the specified endpoint of the ActiveGate plugin.
The request produces an application/json
payload.
GET |
|
Parameters
Parameter | Type | Description | In | Required |
---|---|---|---|---|
id | string |
The ID of the required plugin. |
path | required |
endpointId | string |
The ID of the required endpoint. |
path | required |
Response format
The RemotePluginEndpoint object
Configuration of a plugin endpoint.
Element | Type | Description |
---|---|---|
id | string | The ID of the endpoint. |
pluginId | string | The ID of the plugin to which the endpoint belongs. |
name | string | The name of the endpoint, displayed in DESK. |
enabled | boolean | The endpoint is enabled ( |
properties | object | The list of endpoint parameters. Each parameter is a property-value pair. |
activeGatePluginModule | EntityShortRepresentation | The ActiveGate plugin module that hosts the endpoint. |
The EntityShortRepresentation object
The short representation of a DESK entity.
Element | Type | Description |
---|---|---|
id | string | The ID of the DESK entity. |
name | string | The name of the DESK entity. |
description | string | A short description of the DESK entity. |
{
"id": "-2183662974968812535",
"pluginId": "custom.remote.python.demo",
"name": "Demo endpoint",
"enabled": true,
"properties": {
"serverIp": "127.0.0.1",
"password": "",
"username": "DESK",
"dropdownProperty": "two"
},
"activeGatePluginModule": {
"id": "-8844900174269363000"
}
}
Example
In this example, the request inquires for the parameter of the SAPacceptance endpoint, which has the ID of 5677163660730843402. The endpoint belongs to the SAP plugin that has the ID of custom.remote.python.sap.
The API token is passed in the Authorization header.
The endpoint has the following parameters:
Curl
curl -X GET \
https://mySampleEnv.live.dexp.ae/api/config/v1/plugins/custom.remote.python.sap/endpoints/5677163660730843402 \
-H 'Authorization: Api-token abcdefjhij1234567890'
Request URL
https://mySampleEnv.live.dexp.ae/api/config/v1/plugins/custom.remote.python.sap/endpoints/5677163660730843402
Response body
{
"id": "5677163660730843402",
"pluginId": "custom.remote.python.sap",
"name": "SAPacceptance",
"enabled": true,
"properties": {
"clientno": "001",
"serverIp": "192.168.1.0",
"password": "",
"instance": "00",
"username": "DESK"
},
"activeGatePluginModule": {
"id": "1768386982494938781",
"name": "GDNDYNSYNVSG03"
}
}
Response code
200