Provisioning Service

Retrieve a specific entity.

GEThttps://localhost:16005/api/v1/entity/{uuid}

Path parameters

uuid*string (uuid)

Example: "When looking for the root entity, the uuid 0000-0000-0000 must be entered."

Response

200400403404

Request

JavaScriptCurlPython

const response = await fetch('https://localhost:16005/api/v1/entity/{uuid}', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

400403404

{
  "ErrorDetails": "text"
}

Create a specific entity.

POSThttps://localhost:16005/api/v1/entity/{uuid}

Path parameters

uuid*string (uuid)

Example: "When creating the root entity, the uuid 0000-0000-0000 must be entered. When creating a non-root entity, uuid must be 1"

Body

application/json

Information used to create the new entity

allOfObjectInfo (object)

parentstring (uuid)

If empty, then this is the root entity, otherwise this points to a parent entity

childrenarray of string (uuid)

venuesarray of string (uuid)

The list of UUID of the venues for this entity

contactsarray of string (uuid)

The list of UUID of the contacts for the entity

locationsarray of string (uuid)

The list of UUID of the locations associated with thit entiry

managementPolicystring (uuid)

deviceConfigurationstring (uuid)

devicesarray of string (uuid)

managementPoliciesarray of string (uuid)

The list of UUID of the venues for this entity

variablesarray of string (uuid)

The list of UUID of the venues for this entity

managementRolesarray of string (uuid)

The list of UUID of the venues for this entity

mapsarray of string (uuid)

The list of UUID of the venues for this entity

configurationsarray of string (uuid)

The list of UUID of the venues for this entity

rrmenum

offoninherit

sourceIPStringList (object)

Response

200403404

Request

JavaScriptCurlPython

const response = await fetch('https://localhost:16005/api/v1/entity/{uuid}', {
    method: 'POST',
    headers: {
      "Content-Type": "application/json"
    },
    body: JSON.stringify({}),
});
const data = await response.json();

Response

403404

{
  "ErrorCode": 0,
  "ErrorDetails": "text",
  "ErrorDescription": "text"
}

Modify a specific entity.

PUThttps://localhost:16005/api/v1/entity/{uuid}

Path parameters

uuid*string (uuid)

Example: "When modifying the root entity, the uuid 0000-0000-0000 must be entered."

Body

application/json

Information used to modify the new entity

allOfObjectInfo (object)

parentstring (uuid)

If empty, then this is the root entity, otherwise this points to a parent entity

childrenarray of string (uuid)

venuesarray of string (uuid)

The list of UUID of the venues for this entity

contactsarray of string (uuid)

The list of UUID of the contacts for the entity

locationsarray of string (uuid)

The list of UUID of the locations associated with thit entiry

managementPolicystring (uuid)

deviceConfigurationstring (uuid)

devicesarray of string (uuid)

managementPoliciesarray of string (uuid)

The list of UUID of the venues for this entity

variablesarray of string (uuid)

The list of UUID of the venues for this entity

managementRolesarray of string (uuid)

The list of UUID of the venues for this entity

mapsarray of string (uuid)

The list of UUID of the venues for this entity

configurationsarray of string (uuid)

The list of UUID of the venues for this entity

rrmenum

offoninherit

sourceIPStringList (object)

Response

200403404

Request

JavaScriptCurlPython

const response = await fetch('https://localhost:16005/api/v1/entity/{uuid}', {
    method: 'PUT',
    headers: {
      "Content-Type": "application/json"
    },
    body: JSON.stringify({}),
});
const data = await response.json();

Response

403404

{
  "ErrorCode": 0,
  "ErrorDetails": "text",
  "ErrorDescription": "text"
}

Delete a specific entity.

DELETEhttps://localhost:16005/api/v1/entity/{uuid}

Path parameters

uuid*string (uuid)

Example: "The root entity cannot be deleted."

Response

204403404

The requested operation was performed.

Body

application/json

Operationstring

Detailsstring

Codeinteger

Request

JavaScriptCurlPython

const response = await fetch('https://localhost:16005/api/v1/entity/{uuid}', {
    method: 'DELETE',
    headers: {},
});
const data = await response.json();

Response

204403404

{
  "Operation": "text",
  "Details": "text"
}

Retrieve a list of contacts.

GEThttps://localhost:16005/api/v1/contact

Query parameters

Response

200403404

Return a list of contacts

Body

application/json

one of

ContactList (object)CountAnswer (object)

Request

JavaScriptCurlPython

const response = await fetch('https://localhost:16005/api/v1/contact', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

200403404

{
  "contacts": [
    {
      "allOf": {
        "id": "123e4567-e89b-12d3-a456-426614174000",
        "name": "text",
        "description": "text",
        "notes": [
          {
            "createdBy": "text",
            "note": "text"
          }
        ],
        "tags": []
      },
      "type": "SUBSCRIBER",
      "title": "text",
      "salutation": "text",
      "firstname": "text",
      "lastname": "text",
      "initials": "text",
      "visual": "text",
      "phones": [
        "text"
      ],
      "mobiles": [
        "text"
      ],
      "primaryEmail": "text",
      "secondaryEmail": "text",
      "accessPIN": "text",
      "inUse": [
        "123e4567-e89b-12d3-a456-426614174000"
      ],
      "entity": "123e4567-e89b-12d3-a456-426614174000",
      "managementPolicy": "123e4567-e89b-12d3-a456-426614174000"
    }
  ]
}

Retrieve a specific contact.

GEThttps://localhost:16005/api/v1/contact/{uuid}

Path parameters

uuid*string (uuid)

Query parameters

Response

200403404

Success

Body

application/json

one of

Contact (object)ExpandedUseEntryMapList (object)

Request

JavaScriptCurlPython

const response = await fetch('https://localhost:16005/api/v1/contact/{uuid}', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

200403404

{
  "allOf": {
    "id": "123e4567-e89b-12d3-a456-426614174000",
    "name": "text",
    "description": "text",
    "notes": [
      {
        "createdBy": "text",
        "note": "text"
      }
    ],
    "tags": []
  },
  "type": "SUBSCRIBER",
  "title": "text",
  "salutation": "text",
  "firstname": "text",
  "lastname": "text",
  "initials": "text",
  "visual": "text",
  "phones": [
    "text"
  ],
  "mobiles": [
    "text"
  ],
  "primaryEmail": "text",
  "secondaryEmail": "text",
  "accessPIN": "text",
  "inUse": [
    "123e4567-e89b-12d3-a456-426614174000"
  ],
  "entity": "123e4567-e89b-12d3-a456-426614174000",
  "managementPolicy": "123e4567-e89b-12d3-a456-426614174000"
}

Create a specific entity.

POSThttps://localhost:16005/api/v1/contact/{uuid}

Path parameters

uuid*string (uuid)

Body

application/json

Information used to create the new entity

allOfObjectInfo (object)

typeenum

SUBSCRIBERUSERINSTALLERCSRMANAGERBUSINESSOWNERTECHNICIANCORPORATE

titlestring

salutationstring

firstnamestring

lastnamestring

initialsstring

visualstring

phonesarray of string

mobilesarray of string

primaryEmailstring

secondaryEmailstring

accessPINstring

inUsearray of string (uuid)

entitystring (uuid)

managementPolicystring (uuid)

Response

200403404

Request

JavaScriptCurlPython

const response = await fetch('https://localhost:16005/api/v1/contact/{uuid}', {
    method: 'POST',
    headers: {
      "Content-Type": "application/json"
    },
    body: JSON.stringify({}),
});
const data = await response.json();

Response

403404

{
  "ErrorCode": 0,
  "ErrorDetails": "text",
  "ErrorDescription": "text"
}

Modify a specific contact.

PUThttps://localhost:16005/api/v1/contact/{uuid}

Path parameters

uuid*string (uuid)

Body

application/json

Information used to modify the new entity

allOfObjectInfo (object)

typeenum

SUBSCRIBERUSERINSTALLERCSRMANAGERBUSINESSOWNERTECHNICIANCORPORATE

titlestring

salutationstring

firstnamestring

lastnamestring

initialsstring

visualstring

phonesarray of string

mobilesarray of string

primaryEmailstring

secondaryEmailstring

accessPINstring

inUsearray of string (uuid)

entitystring (uuid)

managementPolicystring (uuid)

Response

200403404

Request

JavaScriptCurlPython

const response = await fetch('https://localhost:16005/api/v1/contact/{uuid}', {
    method: 'PUT',
    headers: {
      "Content-Type": "application/json"
    },
    body: JSON.stringify({}),
});
const data = await response.json();

Response

403404

{
  "ErrorCode": 0,
  "ErrorDetails": "text",
  "ErrorDescription": "text"
}

Delete a specific contact.

DELETEhttps://localhost:16005/api/v1/contact/{uuid}

Path parameters

uuid*string (uuid)

Query parameters

Response

204403404

The requested operation was performed.

Body

application/json

Operationstring

Detailsstring

Codeinteger

Request

JavaScriptCurlPython

const response = await fetch('https://localhost:16005/api/v1/contact/{uuid}?force=false', {
    method: 'DELETE',
    headers: {},
});
const data = await response.json();

Response

204403404

{
  "Operation": "text",
  "Details": "text"
}

Retrieve a list of locations.

GEThttps://localhost:16005/api/v1/location

Query parameters

Response

200403404

Return a list of Locations

Body

application/json

one of

LocationList (object)CountAnswer (object)

Request

JavaScriptCurlPython

const response = await fetch('https://localhost:16005/api/v1/location', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

200403404

{
  "locations": [
    {
      "allOf": {
        "id": "123e4567-e89b-12d3-a456-426614174000",
        "name": "text",
        "description": "text",
        "notes": [
          {
            "createdBy": "text",
            "note": "text"
          }
        ],
        "tags": []
      },
      "type": "SERVICE",
      "buildingName": "text",
      "addressLines": [
        "text"
      ],
      "city": "text",
      "state": "text",
      "postal": "text",
      "country": "text",
      "phones": [
        "text"
      ],
      "mobiles": [
        "text"
      ],
      "inUse": [
        "each uuid is preceded by ent, or ven to say that the elemenet is entity or venue"
      ],
      "entity": "123e4567-e89b-12d3-a456-426614174000",
      "managementPolicy": "123e4567-e89b-12d3-a456-426614174000",
      "geoCode": "text"
    }
  ]
}

Retrieve a specific location.

GEThttps://localhost:16005/api/v1/location/{uuid}

Path parameters

uuid*string (uuid)

Query parameters

Response

200403404

Success

Body

application/json

one of

Location (object)ExpandedUseEntryMapList (object)

Request

JavaScriptCurlPython

const response = await fetch('https://localhost:16005/api/v1/location/{uuid}', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

200403404

{
  "allOf": {
    "id": "123e4567-e89b-12d3-a456-426614174000",
    "name": "text",
    "description": "text",
    "notes": [
      {
        "createdBy": "text",
        "note": "text"
      }
    ],
    "tags": []
  },
  "type": "SERVICE",
  "buildingName": "text",
  "addressLines": [
    "text"
  ],
  "city": "text",
  "state": "text",
  "postal": "text",
  "country": "text",
  "phones": [
    "text"
  ],
  "mobiles": [
    "text"
  ],
  "inUse": [
    "each uuid is preceded by ent, or ven to say that the elemenet is entity or venue"
  ],
  "entity": "123e4567-e89b-12d3-a456-426614174000",
  "managementPolicy": "123e4567-e89b-12d3-a456-426614174000",
  "geoCode": "text"
}

Create a specific location.

POSThttps://localhost:16005/api/v1/location/{uuid}

Path parameters

uuid*string (uuid)

Body

application/json

Information used to create the new location

allOfObjectInfo (object)

typeenum

SERVICEEQUIPMENTAUTOMANUALSPECIALUNKNOWNCORPORATE

buildingNamestring

addressLinesarray of string

citystring

statestring

postalstring

countrystring

phonesarray of string

mobilesarray of string

inUsearray of string (uuid)

entitystring (uuid)

managementPolicystring (uuid)

geoCodestring

Response

200403404

Request

JavaScriptCurlPython

const response = await fetch('https://localhost:16005/api/v1/location/{uuid}', {
    method: 'POST',
    headers: {
      "Content-Type": "application/json"
    },
    body: JSON.stringify({}),
});
const data = await response.json();

Response

403404

{
  "ErrorCode": 0,
  "ErrorDetails": "text",
  "ErrorDescription": "text"
}

Modify a specific location.

PUThttps://localhost:16005/api/v1/location/{uuid}

Path parameters

uuid*string (uuid)

Body

application/json

Information used to modify the new location

allOfObjectInfo (object)

typeenum

SERVICEEQUIPMENTAUTOMANUALSPECIALUNKNOWNCORPORATE

buildingNamestring

addressLinesarray of string

citystring

statestring

postalstring

countrystring

phonesarray of string

mobilesarray of string

inUsearray of string (uuid)

entitystring (uuid)

managementPolicystring (uuid)

geoCodestring

Response

200403404

Request

JavaScriptCurlPython

const response = await fetch('https://localhost:16005/api/v1/location/{uuid}', {
    method: 'PUT',
    headers: {
      "Content-Type": "application/json"
    },
    body: JSON.stringify({}),
});
const data = await response.json();

Response

403404

{
  "ErrorCode": 0,
  "ErrorDetails": "text",
  "ErrorDescription": "text"
}

Delete a specific location.

DELETEhttps://localhost:16005/api/v1/location/{uuid}

Path parameters

uuid*string (uuid)

Query parameters

Response

204403404

The requested operation was performed.

Body

application/json

Operationstring

Detailsstring

Codeinteger

Request

JavaScriptCurlPython

const response = await fetch('https://localhost:16005/api/v1/location/{uuid}?force=false', {
    method: 'DELETE',
    headers: {},
});
const data = await response.json();

Response

204403404

{
  "Operation": "text",
  "Details": "text"
}

Retrieve a list of inventory.

GEThttps://localhost:16005/api/v1/inventory

Query parameters

Response

200400403404

Return a list of elements

Body

application/json

one of

SerialNumberList (object)InventoryTagList (object)CountAnswer (object)

Request

JavaScriptCurlPython

const response = await fetch('https://localhost:16005/api/v1/inventory', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

200400403404

{
  "serialNumbers": [
    "text"
  ]
}

Retrieve a specific inventory tag.

GEThttps://localhost:16005/api/v1/inventory/{serialNumber}

Path parameters

serialNumber*string (uuid)

Query parameters

Response

200400403404

Succesful retrieve configuratiopn or part of the configuration

Body

application/json

one of

InventoryTag (object)FirmwareOptions (object)InventoryConfigApplyResult (object)

Request

JavaScriptCurlPython

const response = await fetch('https://localhost:16005/api/v1/inventory/{serialNumber}', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

200400403404

{
  "allOf": {
    "id": "123e4567-e89b-12d3-a456-426614174000",
    "name": "text",
    "description": "text",
    "notes": [
      {
        "createdBy": "text",
        "note": "text"
      }
    ],
    "tags": []
  },
  "serialNumber": "text",
  "deviceType": "text",
  "venue": "123e4567-e89b-12d3-a456-426614174000",
  "entity": "123e4567-e89b-12d3-a456-426614174000",
  "subscriber": "123e4567-e89b-12d3-a456-426614174000",
  "qrCode": "text",
  "geoCode": "text",
  "location": "123e4567-e89b-12d3-a456-426614174000",
  "contact": "123e4567-e89b-12d3-a456-426614174000",
  "deviceConfiguration": "123e4567-e89b-12d3-a456-426614174000",
  "rrm": "off",
  "managementPolicy": "123e4567-e89b-12d3-a456-426614174000",
  "state": "text",
  "devClass": "any",
  "locale": "text"
}

Create a specific Inventory.

POSThttps://localhost:16005/api/v1/inventory/{serialNumber}

Path parameters

serialNumber*string (uuid)

Body

application/json

Information used to create the new entity

allOfObjectInfo (object)

serialNumberstring

deviceTypestring

venuestring (uuid)

entitystring (uuid)

subscriberstring (uuid)

qrCodestring

geoCodestring

locationstring (uuid)

contactstring (uuid)

deviceConfigurationstring (uuid)

rrmenum

offoninherit

managementPolicystring (uuid)

statestring

devClassenum

anyvenueentitysubscriber

localestring

Response

200403404

Request

JavaScriptCurlPython

const response = await fetch('https://localhost:16005/api/v1/inventory/{serialNumber}', {
    method: 'POST',
    headers: {
      "Content-Type": "application/json"
    },
    body: JSON.stringify({}),
});
const data = await response.json();

Response

403404

{
  "ErrorCode": 0,
  "ErrorDetails": "text",
  "ErrorDescription": "text"
}

Modify a specific inventory.

PUThttps://localhost:16005/api/v1/inventory/{serialNumber}

Path parameters

serialNumber*string (uuid)

removeSubscriber*string (uuid)

Query parameters

Body

application/json

Information used to modify the new entity

allOfObjectInfo (object)

serialNumberstring

deviceTypestring

venuestring (uuid)

entitystring (uuid)

subscriberstring (uuid)

qrCodestring

geoCodestring

locationstring (uuid)

contactstring (uuid)

deviceConfigurationstring (uuid)

rrmenum

offoninherit

managementPolicystring (uuid)

statestring

devClassenum

anyvenueentitysubscriber

localestring

Response

200403404

success

Body

application/json

allOfObjectInfo (object)

serialNumberstring

deviceTypestring

venuestring (uuid)

entitystring (uuid)

subscriberstring (uuid)

qrCodestring

geoCodestring

locationstring (uuid)

contactstring (uuid)

deviceConfigurationstring (uuid)

rrmenum

offoninherit

managementPolicystring (uuid)

statestring

devClassenum

anyvenueentitysubscriber

localestring

Request

JavaScriptCurlPython

const response = await fetch('https://localhost:16005/api/v1/inventory/{serialNumber}', {
    method: 'PUT',
    headers: {
      "Content-Type": "application/json"
    },
    body: JSON.stringify({}),
});
const data = await response.json();

Response

200403404

{
  "allOf": {
    "id": "123e4567-e89b-12d3-a456-426614174000",
    "name": "text",
    "description": "text",
    "notes": [
      {
        "createdBy": "text",
        "note": "text"
      }
    ],
    "tags": []
  },
  "serialNumber": "text",
  "deviceType": "text",
  "venue": "123e4567-e89b-12d3-a456-426614174000",
  "entity": "123e4567-e89b-12d3-a456-426614174000",
  "subscriber": "123e4567-e89b-12d3-a456-426614174000",
  "qrCode": "text",
  "geoCode": "text",
  "location": "123e4567-e89b-12d3-a456-426614174000",
  "contact": "123e4567-e89b-12d3-a456-426614174000",
  "deviceConfiguration": "123e4567-e89b-12d3-a456-426614174000",
  "rrm": "off",
  "managementPolicy": "123e4567-e89b-12d3-a456-426614174000",
  "state": "text",
  "devClass": "any",
  "locale": "text"
}

Delete a specific inventory.

DELETEhttps://localhost:16005/api/v1/inventory/{serialNumber}

Path parameters

serialNumber*string (uuid)

Response

204403404

The requested operation was performed.

Body

application/json

Operationstring

Detailsstring

Codeinteger

Request

JavaScriptCurlPython

const response = await fetch('https://localhost:16005/api/v1/inventory/{serialNumber}', {
    method: 'DELETE',
    headers: {},
});
const data = await response.json();

Response

204403404

{
  "Operation": "text",
  "Details": "text"
}

Retrieve a list of venues.

GEThttps://localhost:16005/api/v1/venue

Query parameters

Response

200403404

Return a list of venues.

Body

application/json

one of

VenueList (object)CountAnswer (object)

Request

JavaScriptCurlPython

const response = await fetch('https://localhost:16005/api/v1/venue', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

200403404

{
  "venues": [
    {
      "allOf": {
        "id": "123e4567-e89b-12d3-a456-426614174000",
        "name": "text",
        "description": "text",
        "notes": [
          {
            "createdBy": "text",
            "note": "text"
          }
        ],
        "tags": []
      },
      "entity": "123e4567-e89b-12d3-a456-426614174000",
      "parent": "123e4567-e89b-12d3-a456-426614174000",
      "children": [
        "123e4567-e89b-12d3-a456-426614174000"
      ],
      "managementPolicy": "123e4567-e89b-12d3-a456-426614174000",
      "devices": [
        "123e4567-e89b-12d3-a456-426614174000"
      ],
      "topology": [
        {
          "parent": "123e4567-e89b-12d3-a456-426614174000",
          "child": "123e4567-e89b-12d3-a456-426614174000"
        }
      ],
      "design": "text",
      "deviceConfiguration": "123e4567-e89b-12d3-a456-426614174000",
      "contacts": [
        "123e4567-e89b-12d3-a456-426614174000"
      ],
      "location": "123e4567-e89b-12d3-a456-426614174000",
      "rrm": "off",
      "sourceIP": {
        "list": [
          "text"
        ]
      },
      "managementPolicies": [
        "123e4567-e89b-12d3-a456-426614174000"
      ],
      "managementRoles": [
        "123e4567-e89b-12d3-a456-426614174000"
      ],
      "variables": [
        "123e4567-e89b-12d3-a456-426614174000"
      ],
      "maps": [
        "123e4567-e89b-12d3-a456-426614174000"
      ],
      "configurations": [
        "123e4567-e89b-12d3-a456-426614174000"
      ]
    }
  ]
}

Retrieve a specific venue.

GEThttps://localhost:16005/api/v1/venue/{uuid}

Path parameters

uuid*string (uuid)

Response

200403404

Request

JavaScriptCurlPython

const response = await fetch('https://localhost:16005/api/v1/venue/{uuid}', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

403404

{
  "ErrorCode": 0,
  "ErrorDetails": "text",
  "ErrorDescription": "text"
}

Create a specific venue.

POSThttps://localhost:16005/api/v1/venue/{uuid}

Path parameters

uuid*string (uuid)

Query parameters

Body

application/json

Information used to create the new venue

allOfObjectInfo (object)

entitystring (uuid)

parentstring (uuid)

childrenarray of string (uuid)

managementPolicystring (uuid)

devicesarray of string (uuid)

topologyDiGraph (array of DiGraphEntry (object))

designstring

deviceConfigurationstring (uuid)

contactsarray of string (uuid)

locationstring (uuid)

rrmenum

offoninherit

sourceIPStringList (object)

managementPoliciesarray of string (uuid)

The list of UUID of the venues for this entity

managementRolesarray of string (uuid)

The list of UUID of the venues for this entity

variablesarray of string (uuid)

The list of UUID of the venues for this entity

mapsarray of string (uuid)

The list of UUID of the venues for this entity

configurationsarray of string (uuid)

The list of UUID of the venues for this entity

Response

200403404

Request

JavaScriptCurlPython

const response = await fetch('https://localhost:16005/api/v1/venue/{uuid}', {
    method: 'POST',
    headers: {
      "Content-Type": "application/json"
    },
    body: JSON.stringify({}),
});
const data = await response.json();

Response

403404

{
  "ErrorCode": 0,
  "ErrorDetails": "text",
  "ErrorDescription": "text"
}

Modify a specific venue.

PUThttps://localhost:16005/api/v1/venue/{uuid}

Path parameters

uuid*string (uuid)

Body

application/json

Information used to modify the new venue

allOfObjectInfo (object)

entitystring (uuid)

parentstring (uuid)

childrenarray of string (uuid)

managementPolicystring (uuid)

devicesarray of string (uuid)

topologyDiGraph (array of DiGraphEntry (object))

designstring

deviceConfigurationstring (uuid)

contactsarray of string (uuid)

locationstring (uuid)

rrmenum

offoninherit

sourceIPStringList (object)

managementPoliciesarray of string (uuid)

The list of UUID of the venues for this entity

managementRolesarray of string (uuid)

The list of UUID of the venues for this entity

variablesarray of string (uuid)

The list of UUID of the venues for this entity

mapsarray of string (uuid)

The list of UUID of the venues for this entity

configurationsarray of string (uuid)

The list of UUID of the venues for this entity

Response

200403404

Request

JavaScriptCurlPython

const response = await fetch('https://localhost:16005/api/v1/venue/{uuid}', {
    method: 'PUT',
    headers: {
      "Content-Type": "application/json"
    },
    body: JSON.stringify({}),
});
const data = await response.json();

Response

403404

{
  "ErrorCode": 0,
  "ErrorDetails": "text",
  "ErrorDescription": "text"
}

Delete a specific venue.

DELETEhttps://localhost:16005/api/v1/venue/{uuid}

Path parameters

uuid*string (uuid)

Example: "The root entity cannot be deleted."

Response

204403404

The requested operation was performed.

Body

application/json

Operationstring

Detailsstring

Codeinteger

Request

JavaScriptCurlPython

const response = await fetch('https://localhost:16005/api/v1/venue/{uuid}', {
    method: 'DELETE',
    headers: {},
});
const data = await response.json();

Response

204403404

{
  "Operation": "text",
  "Details": "text"
}

Retrieve the list of maps

GEThttps://localhost:16005/api/v1/map

Query parameters

Response

200403404

Return a list of Venues

Body

application/json

listarray of Map (object)

Request

JavaScriptCurlPython

const response = await fetch('https://localhost:16005/api/v1/map', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

200403404

{
  "list": [
    {
      "allOf": {
        "id": "123e4567-e89b-12d3-a456-426614174000",
        "name": "text",
        "description": "text",
        "notes": [
          {
            "createdBy": "text",
            "note": "text"
          }
        ],
        "tags": []
      },
      "entity": "123e4567-e89b-12d3-a456-426614174000",
      "venue": "123e4567-e89b-12d3-a456-426614174000",
      "managementPolicy": "123e4567-e89b-12d3-a456-426614174000",
      "data": "text",
      "visibility": "private",
      "creator": "123e4567-e89b-12d3-a456-426614174000",
      "access": {
        "list": [
          {
            "users": {
              "list": [
                "123e4567-e89b-12d3-a456-426614174000"
              ]
            },
            "roles": {
              "list": [
                "123e4567-e89b-12d3-a456-426614174000"
              ]
            },
            "access": "none"
          }
        ]
      }
    }
  ]
}

Retrieve a specific map.

GEThttps://localhost:16005/api/v1/map/{uuid}

Path parameters

uuid*string (uuid)

Response

200403404

Successfull retrieval of a map

Body

application/json

allOfObjectInfo (object)

entitystring (uuid)

venuestring (uuid)

managementPolicystring (uuid)

datastring

visibilityenum

privatepublicselect

creatorstring (uuid)

accessObjectACLList (object)

Request

JavaScriptCurlPython

const response = await fetch('https://localhost:16005/api/v1/map/{uuid}', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

200403404

{
  "allOf": {
    "id": "123e4567-e89b-12d3-a456-426614174000",
    "name": "text",
    "description": "text",
    "notes": [
      {
        "createdBy": "text",
        "note": "text"
      }
    ],
    "tags": []
  },
  "entity": "123e4567-e89b-12d3-a456-426614174000",
  "venue": "123e4567-e89b-12d3-a456-426614174000",
  "managementPolicy": "123e4567-e89b-12d3-a456-426614174000",
  "data": "text",
  "visibility": "private",
  "creator": "123e4567-e89b-12d3-a456-426614174000",
  "access": {
    "list": [
      {
        "users": {
          "list": [
            "123e4567-e89b-12d3-a456-426614174000"
          ]
        },
        "roles": {
          "list": [
            "123e4567-e89b-12d3-a456-426614174000"
          ]
        },
        "access": "none"
      }
    ]
  }
}

Create a specific map.

POSThttps://localhost:16005/api/v1/map/{uuid}

Path parameters

uuid*string (uuid)

Body

application/json

Information used to create the new policy

allOfObjectInfo (object)

entitystring (uuid)

venuestring (uuid)

managementPolicystring (uuid)

datastring

visibilityenum

privatepublicselect

creatorstring (uuid)

accessObjectACLList (object)

Response

200403404

Request

JavaScriptCurlPython

const response = await fetch('https://localhost:16005/api/v1/map/{uuid}', {
    method: 'POST',
    headers: {
      "Content-Type": "application/json"
    },
    body: JSON.stringify({}),
});
const data = await response.json();

Response

403404

{
  "ErrorCode": 0,
  "ErrorDetails": "text",
  "ErrorDescription": "text"
}

Modify a specific map.

PUThttps://localhost:16005/api/v1/map/{uuid}

Path parameters

uuid*string (uuid)

Body

application/json

Information used to modify a map

allOfObjectInfo (object)

entitystring (uuid)

venuestring (uuid)

managementPolicystring (uuid)

datastring

visibilityenum

privatepublicselect

creatorstring (uuid)

accessObjectACLList (object)

Response

200403404

Request

JavaScriptCurlPython

const response = await fetch('https://localhost:16005/api/v1/map/{uuid}', {
    method: 'PUT',
    headers: {
      "Content-Type": "application/json"
    },
    body: JSON.stringify({}),
});
const data = await response.json();

Response

403404

{
  "ErrorCode": 0,
  "ErrorDetails": "text",
  "ErrorDescription": "text"
}

Delete a specific map.

DELETEhttps://localhost:16005/api/v1/map/{uuid}

Path parameters

uuid*string (uuid)

Response

204403404

The requested operation was performed.

Body

application/json

Operationstring

Detailsstring

Codeinteger

Request

JavaScriptCurlPython

const response = await fetch('https://localhost:16005/api/v1/map/{uuid}', {
    method: 'DELETE',
    headers: {},
});
const data = await response.json();

Response

204403404

{
  "Operation": "text",
  "Details": "text"
}

Get a list of policies.

GEThttps://localhost:16005/api/v1/managementPolicy

Query parameters

Response

200403404

Return a list of Venues

Body

application/json

one of

ManagementPolicyList (object)CountAnswer (object)

Request

JavaScriptCurlPython

const response = await fetch('https://localhost:16005/api/v1/managementPolicy', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

200403404

{
  "policies": [
    {
      "allOf": {
        "id": "123e4567-e89b-12d3-a456-426614174000",
        "name": "text",
        "description": "text",
        "notes": [
          {
            "createdBy": "text",
            "note": "text"
          }
        ],
        "tags": []
      },
      "entries": [
        {
          "users": [
            "text"
          ],
          "resources": [
            "text"
          ],
          "access": [
            "NOACCESS"
          ],
          "policy": "text"
        }
      ],
      "inUse": [
        "each uuid is preceded by ent, or ven to say that the elemenet is entity or venue"
      ],
      "entity": "123e4567-e89b-12d3-a456-426614174000",
      "venue": "123e4567-e89b-12d3-a456-426614174000"
    }
  ]
}

Retrieve a specific policy.

GEThttps://localhost:16005/api/v1/managementPolicy/{uuid}

Path parameters

uuid*string (uuid)

Query parameters

Response

200403404

Succesful retrieve a management policy

Body

application/json

one of

ManagementPolicy (object)ExpandedUseEntryMapList (object)

Request

JavaScriptCurlPython

const response = await fetch('https://localhost:16005/api/v1/managementPolicy/{uuid}', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

200403404

{
  "allOf": {
    "id": "123e4567-e89b-12d3-a456-426614174000",
    "name": "text",
    "description": "text",
    "notes": [
      {
        "createdBy": "text",
        "note": "text"
      }
    ],
    "tags": []
  },
  "entries": [
    {
      "users": [
        "text"
      ],
      "resources": [
        "text"
      ],
      "access": [
        "NOACCESS"
      ],
      "policy": "text"
    }
  ],
  "inUse": [
    "each uuid is preceded by ent, or ven to say that the elemenet is entity or venue"
  ],
  "entity": "123e4567-e89b-12d3-a456-426614174000",
  "venue": "123e4567-e89b-12d3-a456-426614174000"
}

Create a specific policy.

POSThttps://localhost:16005/api/v1/managementPolicy/{uuid}

Path parameters

uuid*string (uuid)

Body

application/json

Information used to create the new policy

allOfObjectInfo (object)

entriesarray of ManagementPolicyEntry (object)

inUsearray of string (uuid)

entitystring (uuid)

venuestring (uuid)

Response

200403404

Request

JavaScriptCurlPython

const response = await fetch('https://localhost:16005/api/v1/managementPolicy/{uuid}', {
    method: 'POST',
    headers: {
      "Content-Type": "application/json"
    },
    body: JSON.stringify({}),
});
const data = await response.json();

Response

403404

{
  "ErrorCode": 0,
  "ErrorDetails": "text",
  "ErrorDescription": "text"
}

Modify a specific policy.

PUThttps://localhost:16005/api/v1/managementPolicy/{uuid}

Path parameters

uuid*string (uuid)

Body

application/json

Information used to modify the new policy.

allOfObjectInfo (object)

entriesarray of ManagementPolicyEntry (object)

inUsearray of string (uuid)

entitystring (uuid)

venuestring (uuid)

Response

200403404

Request

JavaScriptCurlPython

const response = await fetch('https://localhost:16005/api/v1/managementPolicy/{uuid}', {
    method: 'PUT',
    headers: {
      "Content-Type": "application/json"
    },
    body: JSON.stringify({}),
});
const data = await response.json();

Response

403404

{
  "ErrorCode": 0,
  "ErrorDetails": "text",
  "ErrorDescription": "text"
}

Delete a specific policy.

DELETEhttps://localhost:16005/api/v1/managementPolicy/{uuid}

Path parameters

uuid*string (uuid)

Example: "The root entity cannot be deleted."

Response

204403404

The requested operation was performed.

Body

application/json

Operationstring

Detailsstring

Codeinteger

Request

JavaScriptCurlPython

const response = await fetch('https://localhost:16005/api/v1/managementPolicy/{uuid}', {
    method: 'DELETE',
    headers: {},
});
const data = await response.json();

Response

204403404

{
  "Operation": "text",
  "Details": "text"
}

Retrieve a list of management roles.

GEThttps://localhost:16005/api/v1/managementRole

Query parameters

Response

200403404

Return a list of elements

Body

application/json

one of

ManagementRoleList (object)CountAnswer (object)

Request

JavaScriptCurlPython

const response = await fetch('https://localhost:16005/api/v1/managementRole', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

200403404

{
  "roles": [
    {
      "allOf": {
        "id": "123e4567-e89b-12d3-a456-426614174000",
        "name": "text",
        "description": "text",
        "notes": [
          {
            "createdBy": "text",
            "note": "text"
          }
        ],
        "tags": []
      },
      "managementPolicy": "123e4567-e89b-12d3-a456-426614174000",
      "users": [
        "123e4567-e89b-12d3-a456-426614174000"
      ],
      "inUse": [
        "each uuid is preceded by ent, or ven to say that the elemenet is entity or venue"
      ],
      "entity": "123e4567-e89b-12d3-a456-426614174000",
      "venue": "123e4567-e89b-12d3-a456-426614174000"
    }
  ]
}

Create a specific management role.

POSThttps://localhost:16005/api/v1/managementRole/{uuid}

Path parameters

uuid*string (uuid)

Example: "during creation, must be set to 1. The real uuid will be returned in the created object"

Body

application/json

Information used to create management role

allOfObjectInfo (object)

managementPolicystring (uuid)

usersarray of string (uuid)

inUsearray of string (uuid)

entitystring (uuid)

venuestring (uuid)

Response

200403404

Request

JavaScriptCurlPython

const response = await fetch('https://localhost:16005/api/v1/managementRole/{uuid}', {
    method: 'POST',
    headers: {
      "Content-Type": "application/json"
    },
    body: JSON.stringify({}),
});
const data = await response.json();

Response

403404

{
  "ErrorCode": 0,
  "ErrorDetails": "text",
  "ErrorDescription": "text"
}

Modify a specific management role.

PUThttps://localhost:16005/api/v1/managementRole/{uuid}

Path parameters

uuid*string (uuid)

Body

application/json

Information used to modify management role

allOfObjectInfo (object)

managementPolicystring (uuid)

usersarray of string (uuid)

inUsearray of string (uuid)

entitystring (uuid)

venuestring (uuid)

Response

200403404

Request

JavaScriptCurlPython

const response = await fetch('https://localhost:16005/api/v1/managementRole/{uuid}', {
    method: 'PUT',
    headers: {
      "Content-Type": "application/json"
    },
    body: JSON.stringify({}),
});
const data = await response.json();

Response

403404

{
  "ErrorCode": 0,
  "ErrorDetails": "text",
  "ErrorDescription": "text"
}

Delete a specific management role.

DELETEhttps://localhost:16005/api/v1/managementRole/{uuid}

Path parameters

uuid*string (uuid)

Response

204403404

The requested operation was performed.

Body

application/json

Operationstring

Detailsstring

Codeinteger

Request

JavaScriptCurlPython

const response = await fetch('https://localhost:16005/api/v1/managementRole/{uuid}', {
    method: 'DELETE',
    headers: {},
});
const data = await response.json();

Response

204403404

{
  "Operation": "text",
  "Details": "text"
}

Retrieve a list of configurations.

GEThttps://localhost:16005/api/v1/configurations

Query parameters

Response

200403404

Return a list of elements

Body

application/json

one of

DeviceConfigurationList (object)CountAnswer (object)

Request

JavaScriptCurlPython

const response = await fetch('https://localhost:16005/api/v1/configurations', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

200403404

{
  "configurations": [
    {
      "allOf": {
        "id": "123e4567-e89b-12d3-a456-426614174000",
        "name": "text",
        "description": "text",
        "notes": [
          {
            "createdBy": "text",
            "note": "text"
          }
        ],
        "tags": []
      },
      "managementPolicy": "123e4567-e89b-12d3-a456-426614174000",
      "deviceTypes": [
        "text"
      ],
      "configuration": [
        {
          "name": "text",
          "description": "text",
          "configuration": "text"
        }
      ],
      "variables": [
        "123e4567-e89b-12d3-a456-426614174000"
      ],
      "inUse": [
        "123e4567-e89b-12d3-a456-426614174000"
      ],
      "subscriberOnly": false,
      "rrm": "off",
      "firmwareUpgrade": "auto or a time string of the format DOW-HH:MM",
      "firmwareRCOnly": false,
      "venue": "123e4567-e89b-12d3-a456-426614174000",
      "entity": "123e4567-e89b-12d3-a456-426614174000",
      "subscriber": "123e4567-e89b-12d3-a456-426614174000"
    }
  ]
}

Retrieve a specific configuration.

GEThttps://localhost:16005/api/v1/configurations/{uuid}

Path parameters

uuid*string (uuid)

Example: "When looking for the root entity, the uuid 0000-0000-0000 must be entered."

Query parameters

Response

200403404

Success

Body

application/json

one of

DeviceConfiguration (object)ExpandedUseEntryMapList (object)

Request

JavaScriptCurlPython

const response = await fetch('https://localhost:16005/api/v1/configurations/{uuid}', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

200403404

{
  "allOf": {
    "id": "123e4567-e89b-12d3-a456-426614174000",
    "name": "text",
    "description": "text",
    "notes": [
      {
        "createdBy": "text",
        "note": "text"
      }
    ],
    "tags": []
  },
  "managementPolicy": "123e4567-e89b-12d3-a456-426614174000",
  "deviceTypes": [
    "text"
  ],
  "configuration": [
    {
      "name": "text",
      "description": "text",
      "configuration": "text"
    }
  ],
  "variables": [
    "123e4567-e89b-12d3-a456-426614174000"
  ],
  "inUse": [
    "123e4567-e89b-12d3-a456-426614174000"
  ],
  "subscriberOnly": false,
  "rrm": "off",
  "firmwareUpgrade": "auto or a time string of the format DOW-HH:MM",
  "firmwareRCOnly": false,
  "venue": "123e4567-e89b-12d3-a456-426614174000",
  "entity": "123e4567-e89b-12d3-a456-426614174000",
  "subscriber": "123e4567-e89b-12d3-a456-426614174000"
}

Create a specific configuration.

POSThttps://localhost:16005/api/v1/configurations/{uuid}

Path parameters

uuid*string (uuid)

Example: "When creating the root entity, the uuid 0000-0000-0000 must be entered. When creating a non-root entity, uuid must be 1"

Query parameters

Body

application/json

Information used to create the new entity

allOfObjectInfo (object)

managementPolicystring (uuid)

deviceTypesarray of string

configurationarray of DeviceConfigurationElement (object)

variablesarray of string (uuid)

inUsearray of string (uuid)

subscriberOnlyboolean

rrmenum

offoninherit

firmwareUpgradestring

Example: "auto or a time string of the format DOW-HH:MM"

firmwareRCOnlyboolean

venuestring (uuid)

entitystring (uuid)

subscriberstring (uuid)

Response

200403404

Request

JavaScriptCurlPython

const response = await fetch('https://localhost:16005/api/v1/configurations/{uuid}', {
    method: 'POST',
    headers: {
      "Content-Type": "application/json"
    },
    body: JSON.stringify({}),
});
const data = await response.json();

Response

403404

{
  "ErrorCode": 0,
  "ErrorDetails": "text",
  "ErrorDescription": "text"
}

Modify a specific configuration.

PUThttps://localhost:16005/api/v1/configurations/{uuid}

Path parameters

uuid*string (uuid)

Example: "When modifying the root entity, the uuid 0000-0000-0000 must be entered."

Body

application/json

Information used to modify the new entity

allOfObjectInfo (object)

managementPolicystring (uuid)

deviceTypesarray of string

configurationarray of DeviceConfigurationElement (object)

variablesarray of string (uuid)

inUsearray of string (uuid)

subscriberOnlyboolean

rrmenum

offoninherit

firmwareUpgradestring

Example: "auto or a time string of the format DOW-HH:MM"

firmwareRCOnlyboolean

venuestring (uuid)

entitystring (uuid)

subscriberstring (uuid)

Response

200403404

Request

JavaScriptCurlPython

const response = await fetch('https://localhost:16005/api/v1/configurations/{uuid}', {
    method: 'PUT',
    headers: {
      "Content-Type": "application/json"
    },
    body: JSON.stringify({}),
});
const data = await response.json();

Response

403404

{
  "ErrorCode": 0,
  "ErrorDetails": "text",
  "ErrorDescription": "text"
}

Delete a specific configuration.

DELETEhttps://localhost:16005/api/v1/configurations/{uuid}

Path parameters

uuid*string (uuid)

Example: "The root entity cannot be deleted."

Response

204403404

The requested operation was performed.

Body

application/json

Operationstring

Detailsstring

Codeinteger

Request

JavaScriptCurlPython

const response = await fetch('https://localhost:16005/api/v1/configurations/{uuid}', {
    method: 'DELETE',
    headers: {},
});
const data = await response.json();

Response

204403404

{
  "Operation": "text",
  "Details": "text"
}

Get the country code for an IP address

GEThttps://localhost:16005/api/v1/iptocountry

Query parameters

Response

200403404

List of country codes.

Body

application/json

enabledboolean

countryCodesarray of string

Request

JavaScriptCurlPython

const response = await fetch('https://localhost:16005/api/v1/iptocountry?iplist=10.2.2.2%2C10.3.4.3', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

200403404

{
  "enabled": false,
  "countryCodes": [
    "text"
  ]
}

This call allows someone to get the status of a signup.

GEThttps://localhost:16005/api/v1/signup

Query parameters

Response

200400403404

Successfull completion

Body

application/json

one of

SignupEntry (object)Dashboard (object)

Request

JavaScriptCurlPython

const response = await fetch('https://localhost:16005/api/v1/signup', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

200400403404

{
  "allOf": {
    "id": "123e4567-e89b-12d3-a456-426614174000",
    "name": "text",
    "description": "text",
    "notes": [
      {
        "createdBy": "text",
        "note": "text"
      }
    ],
    "tags": []
  },
  "email": "[e-mail]",
  "userId": "123e4567-e89b-12d3-a456-426614174000",
  "macAddress": "text",
  "serialNumber": "text",
  "status": "text"
}

This call allows a new subscriber to register themselves and their devices.

POSThttps://localhost:16005/api/v1/signup

Query parameters

Response

200400403404

Request

JavaScriptCurlPython

const response = await fetch('https://localhost:16005/api/v1/signup?email=name%40gmail.com&macAddress=text', {
    method: 'POST',
    headers: {},
});
const data = await response.json();

Response

400403404

{
  "ErrorDetails": "text"
}

modify the signup command in play

PUThttps://localhost:16005/api/v1/signup

Query parameters

Body

application/json

reasonstring

timeinteger (int64)

errorCodeinteger (int32)

statusstring

Response

200400403404

Request

JavaScriptCurlPython

const response = await fetch('https://localhost:16005/api/v1/signup?signupUUID=123e4567-e89b-12d3-a456-426614174000&operation=cancel', {
    method: 'PUT',
    headers: {
      "Content-Type": "application/json"
    },
    body: JSON.stringify({}),
});
const data = await response.json();

Response

400403404

{
  "ErrorDetails": "text"
}

This call allows someone to delete a specific signUp or all signups according to serialNumber of email address

DELETEhttps://localhost:16005/api/v1/signup

Query parameters

Response

204400403404

The requested operation was performed.

Body

application/json

Operationstring

Detailsstring

Codeinteger

Request

JavaScriptCurlPython

const response = await fetch('https://localhost:16005/api/v1/signup', {
    method: 'DELETE',
    headers: {},
});
const data = await response.json();

Response

204400403404

{
  "Operation": "text",
  "Details": "text"
}

Retrieve lists of control blocks

GEThttps://localhost:16005/api/v1/variables

Query parameters

Response

200400403404

Request

JavaScriptCurlPython

const response = await fetch('https://localhost:16005/api/v1/variables', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

400403404

{
  "ErrorDetails": "text"
}

Get the last version of the dashboard.

GEThttps://localhost:16005/api/v1/dashboard

Response

200403404

Request

JavaScriptCurlPython

const response = await fetch('https://localhost:16005/api/v1/dashboard', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

403404

{
  "ErrorCode": 0,
  "ErrorDetails": "text",
  "ErrorDescription": "text"
}

Retrieve different values from the running service.

GEThttps://localhost:16005/api/v1/system

Query parameters

Response

200403404

Successful command execution

Body

application/json

one of

SystemInfoResults (object)

Request

JavaScriptCurlPython

const response = await fetch('https://localhost:16005/api/v1/system?command=info', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

200403404

{
  "version": "text",
  "os": "text",
  "hostname": "text",
  "certificates": [
    {
      "filename": "text"
    }
  ]
}

Perform some system wide commands.

POSThttps://localhost:16005/api/v1/system

Body

application/json

Command details

one of

SystemCommandSetLogLevel (object)SystemCommandReload (object)SystemCommandGetLogLevels (object)SystemCommandGetLogLevelNames (object)SystemCommandGetSubsystemNames (object)

Response

200403404

Successful command execution

Body

application/json

one of

SystemGetLogLevelsResult (object)SystemCommandGetLogLevelNamesResult (object)SystemGetSubSystemNamesResult (object)

Request

JavaScriptCurlPython

const response = await fetch('https://localhost:16005/api/v1/system', {
    method: 'POST',
    headers: {
      "Content-Type": "application/json"
    },
    body: JSON.stringify({}),
});
const data = await response.json();

Response

200403404

{
  "taglist": [
    {
      "tag": "text",
      "value": "text"
    }
  ]
}