SMS API specification (35d0dee47227f4f43bd26a403000ab94c5d128b3)

Download OpenAPI specification:Download

The sms service implements all sms functions for GroupAlarm

alarming

ListConfigurations

Returns all sms-alarming configurations

Authorizations:
API_TokenPersonal-Access-Token
query Parameters
organization_id
required
integer

requesting organization

Responses

Response samples

Content type
application/json
[
  • {
    }
]

UpdateConfiguration

Updates an existing sms-alarming configuration

Authorizations:
API_TokenPersonal-Access-Token
Request Body schema: application/json
required

updated sms-alarming configuration

gsm
string
id
integer <int64>
name
string
organizationID
integer <int64>
pin
string

Responses

Request samples

Content type
application/json
{
  • "gsm": "string",
  • "id": 0,
  • "name": "string",
  • "organizationID": 0,
  • "pin": "string"
}

Response samples

Content type
application/json
{
  • "gsm": "string",
  • "id": 0,
  • "name": "string",
  • "organizationID": 0,
  • "pin": "string"
}

CreateConfiguration

Creates a new sms-alarming configuration

Authorizations:
API_TokenPersonal-Access-Token
Request Body schema: application/json
required

new sms-alarming configuration

gsm
string
id
integer <int64>
name
string
organizationID
integer <int64>
pin
string

Responses

Request samples

Content type
application/json
{
  • "gsm": "string",
  • "id": 0,
  • "name": "string",
  • "organizationID": 0,
  • "pin": "string"
}

Response samples

Content type
application/json
{
  • "gsm": "string",
  • "id": 0,
  • "name": "string",
  • "organizationID": 0,
  • "pin": "string"
}

DeleteConfiguration

Deletes an existing sms-alarming configuration

Authorizations:
API_TokenPersonal-Access-Token
path Parameters
configurationID
required
integer

ID of an existing sms-alarming configuration

Responses

organizations

GetDisabledOrganization

Returns whether the given organization has disabled this way of alarming or not

Authorizations:
API_TokenPersonal-Access-Token
query Parameters
organization_id
required
integer

requesting organization

Responses

Response samples

Content type
application/json
[
  • {
    }
]

SetDisabledOrganization

Sets whether the given organization has this way of alarming disabled or not

Authorizations:
API_TokenPersonal-Access-Token
query Parameters
organization_id
required
integer

requesting organization

Request Body schema: application/json
required

isDisabled payload

isDisabled
boolean

Responses

Request samples

Content type
application/json
{
  • "isDisabled": true
}

text-formatter

GetTextFormatter

Returns the current text formatter of the given organization

Authorizations:
API_TokenPersonal-Access-Token
query Parameters
organization
required
integer

requested organization

Responses

Response samples

Content type
application/json
{
  • "organizationID": 0,
  • "textFormatterName": "string"
}

SetTextFormatter

Sets the given organization's text formatter

Authorizations:
API_TokenPersonal-Access-Token
Request Body schema: application/json
required

organization and it's text formatter settings

organizationID
integer <int64>
textFormatterName
string

Responses

Request samples

Content type
application/json
{
  • "organizationID": 0,
  • "textFormatterName": "string"
}

gsm

List

Returns all gsm numbers for queried owner

Authorizations:
API_TokenPersonal-Access-Token
query Parameters
owner_id
required
integer

requested owner by using his user ID

organization_id
integer

requesting organization, not required if user accesses his own resources

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Update

Updates an existing gsm configuration

Authorizations:
API_TokenPersonal-Access-Token
query Parameters
organization_id
integer

requesting organization, not required if user accesses his own resources

Request Body schema: application/json
required

mobile configuration payload

active
boolean

true, if this configuration can be used for alarm notifications

gsm
string

gsm number for alarm notifications with sms (E.164-format with 00 instead of +)

id
integer <int64>

id for this configuration

name
string

user defined name for this configuration

ownerID
integer <int64>

user id, who owns this configuration

Responses

Request samples

Content type
application/json
{
  • "active": true,
  • "gsm": "string",
  • "id": 0,
  • "name": "string",
  • "ownerID": 0
}

Response samples

Content type
application/json
{
  • "active": true,
  • "gsm": "string",
  • "id": 0,
  • "name": "string",
  • "ownerID": 0
}

Create

Create a gsm configuration for specific user

Authorizations:
API_TokenPersonal-Access-Token
query Parameters
organization_id
integer

requesting organization, not required if user accesses his own resources

Request Body schema: application/json
required

mobile configuration payload

active
boolean

true, if this configuration can be used for alarm notifications

gsm
string

gsm number for alarm notifications with sms (E.164-format with 00 instead of +)

id
integer <int64>

id for this configuration

name
string

user defined name for this configuration

ownerID
integer <int64>

user id, who owns this configuration

Responses

Request samples

Content type
application/json
{
  • "active": true,
  • "gsm": "string",
  • "id": 0,
  • "name": "string",
  • "ownerID": 0
}

Response samples

Content type
application/json
{
  • "active": true,
  • "gsm": "string",
  • "id": 0,
  • "name": "string",
  • "ownerID": 0
}

Delete

Delete an existing gsm configuration

Authorizations:
API_TokenPersonal-Access-Token
path Parameters
mobileID
required
integer

ID of an existing mobile configuration

query Parameters
organization_id
integer

requesting organization, not required if user accesses his own resources

Responses

Response samples

Content type
application/json
{
  • "status": "deleted"
}

Get

Returns an gsm number configuration

Authorizations:
API_TokenPersonal-Access-Token
path Parameters
mobileID
required
integer

ID of an gsm configuration

query Parameters
organization_id
integer

requesting organization, not required if user accesses his own resources

Responses

Response samples

Content type
application/json
[
  • {
    }
]

mobiles

AnyActive

Check if any gsm is active for the passed owner id in the passed organization id and get the permissions of the user and the organization

Authorizations:
API_TokenPersonal-Access-Token
query Parameters
user_id
required
integer

id of the user

organization_id
required
integer

id of the organization

Responses

Response samples

Content type
application/json
{
  • "activeCount": 0,
  • "anyActive": true,
  • "organizationPermission": true,
  • "userPermission": true
}

user-permissions

GetPermission

Returns true if there is an active permission for the passed organization or specifically for the passed user in an organization.

Authorizations:
API_TokenPersonal-Access-Token
query Parameters
organization_id
required
integer

ID of an organization

user_id
integer

optional ID of a user in this organization

Responses

Allows a specific user in a specific organization to use this service's alarming-type.

Authorizations:
API_TokenPersonal-Access-Token
Request Body schema: application/json
required

restriction configuration with user and organization id

organizationID
integer <int64>
userID
integer <int64>

Responses

Request samples

Content type
application/json
{
  • "organizationID": 0,
  • "userID": 0
}

Removes a specific user's permission to use this service's alarming-type in an organization.

Authorizations:
API_TokenPersonal-Access-Token
path Parameters
organizationID
required
integer

ID of an organization

userID
required
integer

ID of a user in this organization

Responses