Sensaphone.net - User contributions [en]

Sensaphone.net API/device

2015-06-02T17:15:26Z

Travis:

=[[Sensaphone.net API]]=

==Specifications==
The '''device''' resource allows access to the devices that are bound to the account.

The device resource has the following properties:
{{TableStart|border_size=1
}}{{TableRowN| '''Parent Property''' | '''Property''' | '''Type''' | '''Description''' | '''Create''' | '''Delete''' | '''Read''' | '''Update'''
}}{{TableRowN| ''<parent>'' | device | Object | The device object. | '''✓''' | '''✓''' | '''✓''' | '''n/a'''
}}{{TableRowN| device | device_id | Integer | ID of the device. | ''' ''' | ''' ''' | '''✓''' | ''' '''
}}{{TableRowN| device | id | String | Unique identifier located on the Device (Serial number, etc.) | ''' ''' | ''' ''' | '''✓''' | ''' '''
}}{{TableRowN| device | name | String | Name of Device | ''' ''' | ''' ''' | '''✓''' | '''✓'''
}}{{TableRowN| device | description | String | Short description of Device | ''' ''' | ''' ''' | '''✓''' | '''✓'''
}}{{TableRowN| device | timezone | String | The timezone the Device is in | ''' ''' | ''' ''' | '''✓''' | '''✓'''
}}{{TableRowN| device | location | Object | Contains location information for the device. | ''' ''' | ''' ''' | '''✓''' | '''✓'''
}}{{TableRowN| location | address | Object | Address information for Device (See [[Sensaphone.net API/address|Sensaphone.net API/address]]) | ''' ''' | ''' ''' | '''✓''' | '''✓'''
}}{{TableRowN| location | coordinates | Object | GPS Coordinates information for Device (See [[Sensaphone.net API/coordinates]]) | ''' ''' | ''' ''' | '''✓''' | '''✓'''
}}{{TableRowN| device | firmware | String | Firmware version of Device | ''' ''' | ''' ''' | '''✓''' | '''✓'''
}}{{TableRowN| device | default_schedule | Object | Alarm Schedule data (See [[Sensaphone.net API/alarmschedule]]) | ''' ''' | ''' ''' | '''✓''' | '''✓'''
}}{{TableRowN| device | device_schedule | Object | Alarm Schedule data (See [[Sensaphone.net API/alarmschedule]]) | ''' ''' | ''' ''' | '''✓''' | '''✓'''
}}{{TableRowN| device | zone | Array of Objects | Device Zone data (See [[Sensaphone.net API/zone|Sensaphone.net API/zone]]) | ''' ''' | ''' ''' | '''✓''' | '''✓'''
}}{{TableRowN| device | offline_timeout | Integer | The number of minutes a device must be offline before it goes into alarm. | ''' ''' | ''' ''' | '''✓''' | '''✓'''
}}{{TableRowN| device | product | String | The name of the product type | ''' ''' | ''' ''' | '''✓''' | ''' '''
}}{{TableRowN| device | modbus_ports | Array of Objects | TBD | ''' ''' | ''' ''' | ''' ''' | ''' '''
}}{{TableRowN| device | zone_meta | Array of Objects | TBD | ''' ''' | ''' ''' | '''✓''' | ''' '''
}}{{TableRowN| zone_meta | zone | Zone Meta Type | TBD | ''' ''' | ''' ''' | '''✓''' | ''' '''
}}{{TableRowN| zone_meta | children | Array of Zone Meta Type | TBD | ''' ''' | ''' ''' | '''✓''' | ''' '''
}}{{TableRowN| device | is_offline_unack | Boolean | Whether or not an unacknowledged offline alarm exists. | ''' ''' | ''' ''' | '''✓''' | ''' '''
}}{{TableRowN| device | is_online | Boolean | Whether or not the device is currently online. | ''' ''' | ''' ''' | '''✓''' | ''' '''
}}{{TableRowN| device | standby_time | String | The number of minutes a device will be in standby mode. | ''' ''' | ''' ''' | '''✓''' | '''✓'''
}}{{TableRowN| device | standby_mode | String | A device's standby mode. | ''' ''' | ''' ''' | '''✓''' | '''✓'''
}}{{TableRowN| device | standby_status | String | A device's standby status | ''' ''' | ''' ''' | '''✓''' | ''' '''
}}{{TableRowN| device | battery_status | String | A device's battery status | ''' ''' | ''' ''' | '''✓''' | ''' '''
}}{{TableRowN| device | power_status | String | A device's power status | ''' ''' | ''' ''' | '''✓''' | ''' '''
}}{{TableRowN| device | connection_status | String | A device's connection status | ''' ''' | ''' ''' | '''✓''' | ''' '''
}}{{TableRowN| device | ack_offline_alarm | String | Acknowledge a device offline alarm | '''✓''' | ''' ''' | ''' ''' | ''' '''
}}{{TableRowN| device | acknowledge_all_alarms | String | Acknowledge all device/zone alarms | '''✓''' | ''' ''' | ''' ''' | ''' '''
}}{{TableRowN| device | clone | Integer | Clone a device's data | ''' ''' | ''' ''' | ''' ''' | '''✓'''
}}{{TableRowN| device | feature | Array of Objects | The feature linked to the device (See [[Sensaphone.net API/feature]]) | ''' ''' | ''' ''' | '''✓''' | '''✓'''
}}{{TableEnd}}

'''Zone Meta Type'''
{{TableStart|border_size=1
}}{{TableRowN| '''Property''' |'''Type''' | '''Description'''
}}{{TableRowN| zone_id | Integer | The Zone ID
}}{{TableRowN| is_enabled | Integer | Is the zone enabled
}}{{TableRowN| hide_if_disabled | Boolean | Hide the zone if disabled
}}{{TableRowN| add_name | String | The add name
}}{{TableEnd}}

===GET===
'''URI Mode Request URI's:'''
*Receive all Device data for all Devices in a user's account
'''GET''' <nowiki>https://</nowiki>rest.sensaphone.net/api/v1/{ACCTID}/{SESSIONID}/device

*Receive all Device data for a specific Device
'''GET''' <nowiki>https://</nowiki>rest.sensaphone.net/api/v1/{ACCTID}/{SESSIONID}/device/{DEVICE_ID}

*Receive the alarm status of a Device
'''GET''' <nowiki>https://</nowiki>rest.sensaphone.net/api/v1/{ACCTID}/{SESSIONID}/device/{DEVICE_ID}/status

'''JSON Mode Request URI:'''
'''POST''' <nowiki>https://</nowiki>rest.sensaphone.net/api/v1/device

'''JSON Mode Request Properties'''
{{TableStart|border_size=1
}}{{TableRowN| '''Parent Property'''|'''Child Property''' |'''Type''' | '''Description'''
}}{{TableRowN|   | acctid | Integer | Account ID
}}{{TableRowN|   | session | Integer | Session ID
}}{{TableRowN|   | request_type | String | "read"
}}{{TableRowN|   | device | Array of Objects | The device object.
}}{{TableEnd}}

'''JSON Mode Response Properties'''
{{TableStart|border_size=1
}}{{TableRowN| '''Parent Property''' |'''Child Property'''|'''Status'''| '''Type''' | '''Description'''
}}{{TableRowN|   | device | Required | Array of Objects | The parent device object.
}}{{TableRowN| device | device_id | Optional | Integer | ID of Device
}}{{TableRowN| device | id | Optional | Integer | Unique identifier located on the Device (Serial number, etc.)
}}{{TableRowN| device | name | Optional | String | Name of Device
}}{{TableRowN| device | description | Optional | String | Short description of Device
}}{{TableRowN| device | timezone | Optional | String | The timezone the Device is in
}}{{TableRowN| device | location | Optional | Object | Contains location information for the device.
}}{{TableRowN| location | address | Optional | Object | Address information for Device (See [[Sensaphone.net API/address]])
}}{{TableRowN| location | coordinates | Optional | Object | GPS Coordinates information for Device (See [[Sensaphone.net API/coordinates]])
}}{{TableRowN| device | firmware | Optional | String | Firmware version of Device
}}{{TableRowN| device | default_schedule | Optional | Object | Alarm Schedule data (See [[Sensaphone.net API/alarmschedule]])
}}{{TableRowN| device | device_schedule | Optional | Object | Alarm Schedule data (See [[Sensaphone.net API/alarmschedule]])
}}{{TableRowN| device | zone | Optional | Array of Objects | Device Zone data (See [[Sensaphone.net API/zone|Sensaphone.net API/zone]])
}}{{TableRowN| device | offline_timeout | Optional | Integer | The number of minutes a device must be offline before it goes into alarm.
}}{{TableRowN| device | product | Optional | String | The name of the product type
}}{{TableRowN| device | modbus_ports | Optional | Array of Objects | TBD
}}{{TableRowN| device | zone_meta | Optional | Array ofObjects | TBD
}}{{TableRowN| zone_meta | zone | Optional | Zone Meta Type | TBD
}}{{TableRowN| zone_meta | children | Optional | Array of Zone Meta Type | TBD
}}{{TableRowN| device | is_offline_unack | Optional | Boolean | Whether or not an '''unacknowledged''' offline alarm exists.
}}{{TableRowN| device | is_online | Optional | Boolean | Whether or not the device is currently online.
}}{{TableRowN| device | standby_time | Optional | String | The number of minutes a device will be in standby mode.
}}{{TableRowN| device | standby_mode | Optional | String | A device's standby mode.
}}{{TableRowN| device | standby_status | Optional | String | A device's standby status
}}{{TableRowN| device | battery_status | Optional | String | A device's battery status
}}{{TableRowN| device | power_status | Optional | String | A device's power status
}}{{TableRowN| device | battery_value | Optional | String | A device's battery value
}}{{TableRowN| device | power_value | Optional | String | A device's power value
}}{{TableRowN| device | connection_status | Optional | String | A device's connection status
}}{{TableRowN| device | feature | Optional | Array of Objects | The feature linked to the account (See [[Sensaphone.net API/feature]])
}}{{TableEnd}}

=====Example JSON=====
Receive all Device information for a specific Device
*'''Request JSON:'''
{
"acctid":987654,
"session":"0123-4567-8901",
"request_type":"read",
"device": {
"device_id":1234
}
}

*'''Response JSON:'''

{
"result":
{
"success":true,
"code":0,
"message":"OK"
},
"response":
{
"device":[
{
"device_id": 1234,
...
}
]
}
}

===PUT===

'''URI Mode Request URI's:'''
*Edit the '''description''' of a Device
'''PUT''' <nowiki>https://</nowiki>rest.sensaphone.net/api/v1/{ACCTID}/{SESSIONID}/device/{DEVICE_ID}/description/{DESCRIPTION}

*Edit the '''name''' of a Device
'''PUT''' <nowiki>https://</nowiki>rest.sensaphone.net/api/v1/{ACCTID}/{SESSIONID}/device/{DEVICE_ID}/name/{DEVICE_NAME}

'''JSON Mode Request URI:'''
'''POST''' <nowiki>https://</nowiki>rest.sensaphone.net/api/v1/device

'''JSON Mode Request Properties'''
{{TableStart|border_size=1
}}{{TableRowN| '''Parent Property'''|'''Child Property''' |'''Type''' | '''Description'''
}}{{TableRowN|   | acctid | Integer | Account ID
}}{{TableRowN|   | session | Integer | Session ID
}}{{TableRowN|   | request_type | String | "update"
}}{{TableRowN|   | device | Array of Objects | The device object.
}}{{TableRowN| device | device_id | Integer | ID of the device.
}}{{TableRowN| device | '''CHILD PROPERTY''' |   | Device's child properties to be edited*
}}{{TableEnd}}
<nowiki>*</nowiki>One or more '''device''' child properties below are required in addition to "device_id".

'''JSON Mode Response Properties'''
{{TableStart|border_size=1
}}{{TableRowN| '''Parent Property''' |'''Child Property'''|'''Status'''| '''Type''' | '''Description'''
}}{{TableRowN|   | device | Required | Array of Objects | The parent device object.
}}{{TableRowN| device | device_id | Optional | Integer | ID of Device
}}{{TableRowN| device | name | Optional | String | Name of Device
}}{{TableRowN| device | description | Optional | String | Short description of Device
}}{{TableRowN| device | timezone | Optional | String | The timezone the Device is in
}}{{TableRowN| device | location | Optional | Object | Contains location information for the device.
}}{{TableRowN| location | address | Optional | Object | Address information for Device (See [[Sensaphone.net API/address|Sensaphone.net API/address]])
}}{{TableRowN| location | coordinates | Optional | Object | GPS Coordinates information for Device (See [[Sensaphone.net API/coordinates]])
}}{{TableRowN| device | firmware | Optional | String | Firmware version of Device
}}{{TableRowN| device | default_schedule | Optional | Object | Alarm Schedule data (See [[Sensaphone.net API/alarmschedule]])
}}{{TableRowN| device | device_schedule | Optional | Object | Alarm Schedule data (See [[Sensaphone.net API/alarmschedule]])
}}{{TableRowN| device | zone | Optional | Array of Objects | Device Zone data (See [[Sensaphone.net API/zone|Sensaphone.net API/zone]])
}}{{TableRowN| device | offline_timeout | Optional | Integer | The number of minutes a device must be offline before it goes into alarm.
}}{{TableRowN| device | modbus_ports | Optional | Array of Objects | TBD
}}{{TableRowN| device | standby_time | Optional | String | The number of minutes a device will be in standby mode.
}}{{TableRowN| device | standby_mode | Optional | String | A device's standby mode.
}}{{TableRowN| device | clone | Optional | Integer | Destination device_id to clone this device's data to
}}{{TableRowN| device | feature | Optional | Array of Objects | The feature linked to the device (See [[Sensaphone.net API/feature]])
}}{{TableEnd}}

===POST===
'''Adding a device'''

The preferred method to add a new Device is to use the JSON Mode Request. If the URI Mode Request is used you will be adding a Device with only the '''id''' value (not to be confused with the '''device_id'''), all other values will be left empty until a PUT request is used. With the JSON Mode Request you can add a Device with all values defined in one step.

'''URI Mode Request URI:'''
*Add a new Device
'''POST''' <nowiki>https://</nowiki>rest.sensaphone.net/api/v1/{ACCTID}/{SESSIONID}/device/id/{DEVICEID}

'''JSON Mode Request URI:'''
'''POST''' <nowiki>https://</nowiki>rest.sensaphone.net/api/v1/device

'''JSON Mode Request Properties'''
{{TableStart|border_size=1
}}{{TableRowN| '''Parent Property'''|'''Child Property''' |'''Type''' | '''Description'''
}}{{TableRowN|   | acctid | Integer | Account ID
}}{{TableRowN|   | session | Integer | Session ID
}}{{TableRowN|   | request_type | String | "create"
}}{{TableRowN|   | device | Array of Objects | The device object.
}}{{TableRowN| device | id | Integer | Unique identifier located on the Device (Serial number, etc.)
}}{{TableEnd}}

'''JSON Mode Response Properties'''
{{TableStart|border_size=1
}}{{TableRowN| '''Parent Property''' |'''Child Property'''|'''Status'''| '''Type''' | '''Description'''
}}{{TableRowN|   | device | Required | Array of Objects | The parent device object.
}}{{TableRowN| device | device_id | Optional | Integer | ID of Device
}}{{TableRowN| device | id | Optional | Integer | Unique identifier located on the Device (Serial number, etc.)
}}{{TableRowN| device | name | Optional | String | Name of Device
}}{{TableRowN| device | description | Optional | String | Short description of Device
}}{{TableRowN| device | location | Optional | Object | Contains location information for the device.
}}{{TableRowN| location | address | Optional | Object | Address information for Device (See [[Sensaphone.net API/address|Sensaphone.net API/address]])
}}{{TableRowN| location | coordinates | Optional | Object | GPS Coordinates information for Device (See [[Sensaphone.net API/coordinates]])
}}{{TableRowN| device | firmware | Optional | String | Firmware version of Device
}}{{TableRowN| device | default_schedule | Optional | Object | Alarm Schedule data (See [[Sensaphone.net API/alarmschedule]])
}}{{TableRowN| device | device_schedule | Optional | Object | Alarm Schedule data (See [[Sensaphone.net API/alarmschedule]])
}}{{TableRowN| device | zone | Optional | Array of Objects | Device Zone data (See [[Sensaphone.net API/zone|Sensaphone.net API/zone]])
}}{{TableRowN| device | offline_timeout | Optional | Integer | The number of minutes a device must be offline before it goes into alarm.
}}{{TableRowN| device | modbus_ports | Optional | Array of Objects | TBD
}}{{TableEnd}}

'''Acknowledging Alarms'''

'''URI Mode Request URI:'''
*Acknowledge All Alarms
'''POST''' <nowiki>https://</nowiki>rest.sensaphone.net/api/v1/{ACCTID}/{SESSIONID}/device/{DEVICE_ID}/acknowledge_all_alarms/{true}

'''JSON Mode Request Properties'''
{{TableStart|border_size=1
}}{{TableRowN| '''Parent Property'''|'''Child Property''' |'''Type''' | '''Description'''
}}{{TableRowN|   | acctid | Integer | Account ID
}}{{TableRowN|   | session | Integer | Session ID
}}{{TableRowN|   | request_type | String | "create"
}}{{TableRowN|   | device | Array of Objects | The device object.
}}{{TableRowN| device | device_id | Integer | ID of Device
}}{{TableRowN| device | ack_offline_alarm | Boolean | A write-only property that will acknowledge a device offline alarm
}}{{TableRowN| device | acknowledge_all_alarms | Boolean | A write-only property that will acknowledge all alarms for a device, including all device alarms and all zone alarms
}}{{TableEnd}}
<nowiki>*</nowiki> "acknowledge_all_alarms" supersedes "ack_offline_alarm", if it is present in the request json other properties will be ignored

===DELETE===
'''URI Mode Request URI:'''
*Delete a Device from an account
'''DELETE''' <nowiki>https://</nowiki>rest.sensaphone.net/api/v1/{ACCTID}/{SESSIONID}/device/{DEVICE_ID}

'''JSON Mode Request URI:'''
'''POST''' <nowiki>https://</nowiki>rest.sensaphone.net/api/v1/device

'''JSON Mode Request Properties'''
{{TableStart|border_size=1
}}{{TableRowN| '''Parent Property'''|'''Child Property''' |'''Type''' | '''Description'''
}}{{TableRowN|   | acctid | Integer | Account ID
}}{{TableRowN|   | session | Integer | Session ID
}}{{TableRowN|   | request_type | String | "delete"
}}{{TableRowN|   | device | Array of Objects | The device object.
}}{{TableRowN| device | device_id | Integer | ID of the device.
}}{{TableEnd}}

Sensaphone.net API/device

2015-06-02T15:41:46Z

Travis: Changing device clone type to Array of Objects

=[[Sensaphone.net API]]=

==Specifications==
The '''device''' resource allows access to the devices that are bound to the account.

The device resource has the following properties:
{{TableStart|border_size=1
}}{{TableRowN| '''Parent Property''' | '''Property''' | '''Type''' | '''Description''' | '''Create''' | '''Delete''' | '''Read''' | '''Update'''
}}{{TableRowN| ''<parent>'' | device | Object | The device object. | '''✓''' | '''✓''' | '''✓''' | '''n/a'''
}}{{TableRowN| device | device_id | Integer | ID of the device. | ''' ''' | ''' ''' | '''✓''' | ''' '''
}}{{TableRowN| device | id | String | Unique identifier located on the Device (Serial number, etc.) | ''' ''' | ''' ''' | '''✓''' | ''' '''
}}{{TableRowN| device | name | String | Name of Device | ''' ''' | ''' ''' | '''✓''' | '''✓'''
}}{{TableRowN| device | description | String | Short description of Device | ''' ''' | ''' ''' | '''✓''' | '''✓'''
}}{{TableRowN| device | timezone | String | The timezone the Device is in | ''' ''' | ''' ''' | '''✓''' | '''✓'''
}}{{TableRowN| device | location | Object | Contains location information for the device. | ''' ''' | ''' ''' | '''✓''' | '''✓'''
}}{{TableRowN| location | address | Object | Address information for Device (See [[Sensaphone.net API/address|Sensaphone.net API/address]]) | ''' ''' | ''' ''' | '''✓''' | '''✓'''
}}{{TableRowN| location | coordinates | Object | GPS Coordinates information for Device (See [[Sensaphone.net API/coordinates]]) | ''' ''' | ''' ''' | '''✓''' | '''✓'''
}}{{TableRowN| device | firmware | String | Firmware version of Device | ''' ''' | ''' ''' | '''✓''' | '''✓'''
}}{{TableRowN| device | default_schedule | Object | Alarm Schedule data (See [[Sensaphone.net API/alarmschedule]]) | ''' ''' | ''' ''' | '''✓''' | '''✓'''
}}{{TableRowN| device | device_schedule | Object | Alarm Schedule data (See [[Sensaphone.net API/alarmschedule]]) | ''' ''' | ''' ''' | '''✓''' | '''✓'''
}}{{TableRowN| device | zone | Array of Objects | Device Zone data (See [[Sensaphone.net API/zone|Sensaphone.net API/zone]]) | ''' ''' | ''' ''' | '''✓''' | '''✓'''
}}{{TableRowN| device | offline_timeout | Integer | The number of minutes a device must be offline before it goes into alarm. | ''' ''' | ''' ''' | '''✓''' | '''✓'''
}}{{TableRowN| device | product | String | The name of the product type | ''' ''' | ''' ''' | '''✓''' | ''' '''
}}{{TableRowN| device | modbus_ports | Array of Objects | TBD | ''' ''' | ''' ''' | ''' ''' | ''' '''
}}{{TableRowN| device | zone_meta | Array of Objects | TBD | ''' ''' | ''' ''' | '''✓''' | ''' '''
}}{{TableRowN| zone_meta | zone | Zone Meta Type | TBD | ''' ''' | ''' ''' | '''✓''' | ''' '''
}}{{TableRowN| zone_meta | children | Array of Zone Meta Type | TBD | ''' ''' | ''' ''' | '''✓''' | ''' '''
}}{{TableRowN| device | is_offline_unack | Boolean | Whether or not an unacknowledged offline alarm exists. | ''' ''' | ''' ''' | '''✓''' | ''' '''
}}{{TableRowN| device | is_online | Boolean | Whether or not the device is currently online. | ''' ''' | ''' ''' | '''✓''' | ''' '''
}}{{TableRowN| device | standby_time | String | The number of minutes a device will be in standby mode. | ''' ''' | ''' ''' | '''✓''' | '''✓'''
}}{{TableRowN| device | standby_mode | String | A device's standby mode. | ''' ''' | ''' ''' | '''✓''' | '''✓'''
}}{{TableRowN| device | standby_status | String | A device's standby status | ''' ''' | ''' ''' | '''✓''' | ''' '''
}}{{TableRowN| device | battery_status | String | A device's battery status | ''' ''' | ''' ''' | '''✓''' | ''' '''
}}{{TableRowN| device | power_status | String | A device's power status | ''' ''' | ''' ''' | '''✓''' | ''' '''
}}{{TableRowN| device | connection_status | String | A device's connection status | ''' ''' | ''' ''' | '''✓''' | ''' '''
}}{{TableRowN| device | ack_offline_alarm | String | Acknowledge a device offline alarm | '''✓''' | ''' ''' | ''' ''' | ''' '''
}}{{TableRowN| device | acknowledge_all_alarms | String | Acknowledge all device/zone alarms | '''✓''' | ''' ''' | ''' ''' | ''' '''
}}{{TableRowN| device | clone | Array of Objects | Clone a device's data | ''' ''' | ''' ''' | ''' ''' | '''✓'''
}}{{TableRowN| device | feature | Array of Objects | The feature linked to the device (See [[Sensaphone.net API/feature]]) | ''' ''' | ''' ''' | '''✓''' | '''✓'''
}}{{TableEnd}}

'''Zone Meta Type'''
{{TableStart|border_size=1
}}{{TableRowN| '''Property''' |'''Type''' | '''Description'''
}}{{TableRowN| zone_id | Integer | The Zone ID
}}{{TableRowN| is_enabled | Integer | Is the zone enabled
}}{{TableRowN| hide_if_disabled | Boolean | Hide the zone if disabled
}}{{TableRowN| add_name | String | The add name
}}{{TableEnd}}

===GET===
'''URI Mode Request URI's:'''
*Receive all Device data for all Devices in a user's account
'''GET''' <nowiki>https://</nowiki>rest.sensaphone.net/api/v1/{ACCTID}/{SESSIONID}/device

*Receive all Device data for a specific Device
'''GET''' <nowiki>https://</nowiki>rest.sensaphone.net/api/v1/{ACCTID}/{SESSIONID}/device/{DEVICE_ID}

*Receive the alarm status of a Device
'''GET''' <nowiki>https://</nowiki>rest.sensaphone.net/api/v1/{ACCTID}/{SESSIONID}/device/{DEVICE_ID}/status

'''JSON Mode Request URI:'''
'''POST''' <nowiki>https://</nowiki>rest.sensaphone.net/api/v1/device

'''JSON Mode Request Properties'''
{{TableStart|border_size=1
}}{{TableRowN| '''Parent Property'''|'''Child Property''' |'''Type''' | '''Description'''
}}{{TableRowN|   | acctid | Integer | Account ID
}}{{TableRowN|   | session | Integer | Session ID
}}{{TableRowN|   | request_type | String | "read"
}}{{TableRowN|   | device | Array of Objects | The device object.
}}{{TableEnd}}

'''JSON Mode Response Properties'''
{{TableStart|border_size=1
}}{{TableRowN| '''Parent Property''' |'''Child Property'''|'''Status'''| '''Type''' | '''Description'''
}}{{TableRowN|   | device | Required | Array of Objects | The parent device object.
}}{{TableRowN| device | device_id | Optional | Integer | ID of Device
}}{{TableRowN| device | id | Optional | Integer | Unique identifier located on the Device (Serial number, etc.)
}}{{TableRowN| device | name | Optional | String | Name of Device
}}{{TableRowN| device | description | Optional | String | Short description of Device
}}{{TableRowN| device | timezone | Optional | String | The timezone the Device is in
}}{{TableRowN| device | location | Optional | Object | Contains location information for the device.
}}{{TableRowN| location | address | Optional | Object | Address information for Device (See [[Sensaphone.net API/address]])
}}{{TableRowN| location | coordinates | Optional | Object | GPS Coordinates information for Device (See [[Sensaphone.net API/coordinates]])
}}{{TableRowN| device | firmware | Optional | String | Firmware version of Device
}}{{TableRowN| device | default_schedule | Optional | Object | Alarm Schedule data (See [[Sensaphone.net API/alarmschedule]])
}}{{TableRowN| device | device_schedule | Optional | Object | Alarm Schedule data (See [[Sensaphone.net API/alarmschedule]])
}}{{TableRowN| device | zone | Optional | Array of Objects | Device Zone data (See [[Sensaphone.net API/zone|Sensaphone.net API/zone]])
}}{{TableRowN| device | offline_timeout | Optional | Integer | The number of minutes a device must be offline before it goes into alarm.
}}{{TableRowN| device | product | Optional | String | The name of the product type
}}{{TableRowN| device | modbus_ports | Optional | Array of Objects | TBD
}}{{TableRowN| device | zone_meta | Optional | Array ofObjects | TBD
}}{{TableRowN| zone_meta | zone | Optional | Zone Meta Type | TBD
}}{{TableRowN| zone_meta | children | Optional | Array of Zone Meta Type | TBD
}}{{TableRowN| device | is_offline_unack | Optional | Boolean | Whether or not an '''unacknowledged''' offline alarm exists.
}}{{TableRowN| device | is_online | Optional | Boolean | Whether or not the device is currently online.
}}{{TableRowN| device | standby_time | Optional | String | The number of minutes a device will be in standby mode.
}}{{TableRowN| device | standby_mode | Optional | String | A device's standby mode.
}}{{TableRowN| device | standby_status | Optional | String | A device's standby status
}}{{TableRowN| device | battery_status | Optional | String | A device's battery status
}}{{TableRowN| device | power_status | Optional | String | A device's power status
}}{{TableRowN| device | battery_value | Optional | String | A device's battery value
}}{{TableRowN| device | power_value | Optional | String | A device's power value
}}{{TableRowN| device | connection_status | Optional | String | A device's connection status
}}{{TableRowN| device | feature | Optional | Array of Objects | The feature linked to the account (See [[Sensaphone.net API/feature]])
}}{{TableEnd}}

=====Example JSON=====
Receive all Device information for a specific Device
*'''Request JSON:'''
{
"acctid":987654,
"session":"0123-4567-8901",
"request_type":"read",
"device": {
"device_id":1234
}
}

*'''Response JSON:'''

{
"result":
{
"success":true,
"code":0,
"message":"OK"
},
"response":
{
"device":[
{
"device_id": 1234,
...
}
]
}
}

===PUT===

'''URI Mode Request URI's:'''
*Edit the '''description''' of a Device
'''PUT''' <nowiki>https://</nowiki>rest.sensaphone.net/api/v1/{ACCTID}/{SESSIONID}/device/{DEVICE_ID}/description/{DESCRIPTION}

*Edit the '''name''' of a Device
'''PUT''' <nowiki>https://</nowiki>rest.sensaphone.net/api/v1/{ACCTID}/{SESSIONID}/device/{DEVICE_ID}/name/{DEVICE_NAME}

'''JSON Mode Request URI:'''
'''POST''' <nowiki>https://</nowiki>rest.sensaphone.net/api/v1/device

'''JSON Mode Request Properties'''
{{TableStart|border_size=1
}}{{TableRowN| '''Parent Property'''|'''Child Property''' |'''Type''' | '''Description'''
}}{{TableRowN|   | acctid | Integer | Account ID
}}{{TableRowN|   | session | Integer | Session ID
}}{{TableRowN|   | request_type | String | "update"
}}{{TableRowN|   | device | Array of Objects | The device object.
}}{{TableRowN| device | device_id | Integer | ID of the device.
}}{{TableRowN| device | '''CHILD PROPERTY''' |   | Device's child properties to be edited*
}}{{TableEnd}}
<nowiki>*</nowiki>One or more '''device''' child properties below are required in addition to "device_id".

'''JSON Mode Response Properties'''
{{TableStart|border_size=1
}}{{TableRowN| '''Parent Property''' |'''Child Property'''|'''Status'''| '''Type''' | '''Description'''
}}{{TableRowN|   | device | Required | Array of Objects | The parent device object.
}}{{TableRowN| device | device_id | Optional | Integer | ID of Device
}}{{TableRowN| device | name | Optional | String | Name of Device
}}{{TableRowN| device | description | Optional | String | Short description of Device
}}{{TableRowN| device | timezone | Optional | String | The timezone the Device is in
}}{{TableRowN| device | location | Optional | Object | Contains location information for the device.
}}{{TableRowN| location | address | Optional | Object | Address information for Device (See [[Sensaphone.net API/address|Sensaphone.net API/address]])
}}{{TableRowN| location | coordinates | Optional | Object | GPS Coordinates information for Device (See [[Sensaphone.net API/coordinates]])
}}{{TableRowN| device | firmware | Optional | String | Firmware version of Device
}}{{TableRowN| device | default_schedule | Optional | Object | Alarm Schedule data (See [[Sensaphone.net API/alarmschedule]])
}}{{TableRowN| device | device_schedule | Optional | Object | Alarm Schedule data (See [[Sensaphone.net API/alarmschedule]])
}}{{TableRowN| device | zone | Optional | Array of Objects | Device Zone data (See [[Sensaphone.net API/zone|Sensaphone.net API/zone]])
}}{{TableRowN| device | offline_timeout | Optional | Integer | The number of minutes a device must be offline before it goes into alarm.
}}{{TableRowN| device | modbus_ports | Optional | Array of Objects | TBD
}}{{TableRowN| device | standby_time | Optional | String | The number of minutes a device will be in standby mode.
}}{{TableRowN| device | standby_mode | Optional | String | A device's standby mode.
}}{{TableRowN| device | clone | Optional | Array of Objects | Destination device_id(s) to clone this device's data to
}}{{TableRowN| device | feature | Optional | Array of Objects | The feature linked to the device (See [[Sensaphone.net API/feature]])
}}{{TableEnd}}

===POST===
'''Adding a device'''

The preferred method to add a new Device is to use the JSON Mode Request. If the URI Mode Request is used you will be adding a Device with only the '''id''' value (not to be confused with the '''device_id'''), all other values will be left empty until a PUT request is used. With the JSON Mode Request you can add a Device with all values defined in one step.

'''URI Mode Request URI:'''
*Add a new Device
'''POST''' <nowiki>https://</nowiki>rest.sensaphone.net/api/v1/{ACCTID}/{SESSIONID}/device/id/{DEVICEID}

'''JSON Mode Request URI:'''
'''POST''' <nowiki>https://</nowiki>rest.sensaphone.net/api/v1/device

'''JSON Mode Request Properties'''
{{TableStart|border_size=1
}}{{TableRowN| '''Parent Property'''|'''Child Property''' |'''Type''' | '''Description'''
}}{{TableRowN|   | acctid | Integer | Account ID
}}{{TableRowN|   | session | Integer | Session ID
}}{{TableRowN|   | request_type | String | "create"
}}{{TableRowN|   | device | Array of Objects | The device object.
}}{{TableRowN| device | id | Integer | Unique identifier located on the Device (Serial number, etc.)
}}{{TableEnd}}

'''JSON Mode Response Properties'''
{{TableStart|border_size=1
}}{{TableRowN| '''Parent Property''' |'''Child Property'''|'''Status'''| '''Type''' | '''Description'''
}}{{TableRowN|   | device | Required | Array of Objects | The parent device object.
}}{{TableRowN| device | device_id | Optional | Integer | ID of Device
}}{{TableRowN| device | id | Optional | Integer | Unique identifier located on the Device (Serial number, etc.)
}}{{TableRowN| device | name | Optional | String | Name of Device
}}{{TableRowN| device | description | Optional | String | Short description of Device
}}{{TableRowN| device | location | Optional | Object | Contains location information for the device.
}}{{TableRowN| location | address | Optional | Object | Address information for Device (See [[Sensaphone.net API/address|Sensaphone.net API/address]])
}}{{TableRowN| location | coordinates | Optional | Object | GPS Coordinates information for Device (See [[Sensaphone.net API/coordinates]])
}}{{TableRowN| device | firmware | Optional | String | Firmware version of Device
}}{{TableRowN| device | default_schedule | Optional | Object | Alarm Schedule data (See [[Sensaphone.net API/alarmschedule]])
}}{{TableRowN| device | device_schedule | Optional | Object | Alarm Schedule data (See [[Sensaphone.net API/alarmschedule]])
}}{{TableRowN| device | zone | Optional | Array of Objects | Device Zone data (See [[Sensaphone.net API/zone|Sensaphone.net API/zone]])
}}{{TableRowN| device | offline_timeout | Optional | Integer | The number of minutes a device must be offline before it goes into alarm.
}}{{TableRowN| device | modbus_ports | Optional | Array of Objects | TBD
}}{{TableEnd}}

'''Acknowledging Alarms'''

'''URI Mode Request URI:'''
*Acknowledge All Alarms
'''POST''' <nowiki>https://</nowiki>rest.sensaphone.net/api/v1/{ACCTID}/{SESSIONID}/device/{DEVICE_ID}/acknowledge_all_alarms/{true}

'''JSON Mode Request Properties'''
{{TableStart|border_size=1
}}{{TableRowN| '''Parent Property'''|'''Child Property''' |'''Type''' | '''Description'''
}}{{TableRowN|   | acctid | Integer | Account ID
}}{{TableRowN|   | session | Integer | Session ID
}}{{TableRowN|   | request_type | String | "create"
}}{{TableRowN|   | device | Array of Objects | The device object.
}}{{TableRowN| device | device_id | Integer | ID of Device
}}{{TableRowN| device | ack_offline_alarm | Boolean | A write-only property that will acknowledge a device offline alarm
}}{{TableRowN| device | acknowledge_all_alarms | Boolean | A write-only property that will acknowledge all alarms for a device, including all device alarms and all zone alarms
}}{{TableEnd}}
<nowiki>*</nowiki> "acknowledge_all_alarms" supersedes "ack_offline_alarm", if it is present in the request json other properties will be ignored

===DELETE===
'''URI Mode Request URI:'''
*Delete a Device from an account
'''DELETE''' <nowiki>https://</nowiki>rest.sensaphone.net/api/v1/{ACCTID}/{SESSIONID}/device/{DEVICE_ID}

'''JSON Mode Request URI:'''
'''POST''' <nowiki>https://</nowiki>rest.sensaphone.net/api/v1/device

'''JSON Mode Request Properties'''
{{TableStart|border_size=1
}}{{TableRowN| '''Parent Property'''|'''Child Property''' |'''Type''' | '''Description'''
}}{{TableRowN|   | acctid | Integer | Account ID
}}{{TableRowN|   | session | Integer | Session ID
}}{{TableRowN|   | request_type | String | "delete"
}}{{TableRowN|   | device | Array of Objects | The device object.
}}{{TableRowN| device | device_id | Integer | ID of the device.
}}{{TableEnd}}

Sensaphone.net API

2015-05-14T19:42:39Z

Travis:

==Overview==
The Sensaphone.net API will be used as a resource for proprietary products (such as mobile applications) and 3rd party clients. It uses a [[wikipedia:REST|REST]] architecture over HTTPS using JSON as the data format. HTTP is not supported. The service can be accessed in one of two modes: URI mode and JSON mode.

In '''''URI mode''''', the following HTTPS methods are used to access the REST resources as [[wikipedia:CRUD|CRUD]].
::{{TableStart|border_size=1
}}{{TableRowN| '''Method''' | '''Description'''
}}{{TableRowN| POST | '''C'''reate
}}{{TableRowN| GET | '''R'''ead
}}{{TableRowN| PUT | '''U'''pdate
}}{{TableRowN| DELETE | '''D'''elete
}}{{TableEnd}}
All parameters are specified in the URI and JSON is only used in the response.

In '''''JSON Mode''''', only the POST method is used to Create, Read, Update, and Delete fields. A "request_type"(create,read,update,delete) JSON property is used to distinguish which method to execute.

==Definitions==
:'''Resource''': A resource is a primary source of data. Examples: device, zone.
:'''Property''': A property is a discrete source of data within a resource (e.g. Device's name). A property may also be a resource (e.g. Device's zone).
:'''ID''': Resources have properties that uniquely identify them. For example, a device has a "device_id", a zone has a "zone_id". These identifying properties are optional or required (See [[#URI Syntax|URI Syntax]]) when accessing (read). They are required when modifying (update or delete) a specific existing resource. When creating they are required except for the resource being created. For a create, the newly created ID will typically be returned in the JSON result.

==URI Syntax==
The URIs are descriptive representations of what the client will receive as a response and will follow one of the formats:

/api/v1[/{''ACCTID''}/{''SESSIONID''}]/'''login'''/[/{''USERNAME''}/{''PASSWORD''}]
/api/v1[/{''ACCTID''}/{''SESSIONID''}][/'''Resource'''[/{''ID''}]]...[/'''Resource'''[/{''ID''}]]/'''Property'''[/{''VALUE''}]]
/api/v1[/{''ACCTID''}/{''SESSIONID''}][/'''Resource'''[/{''ID''}]]...[/'''Resource'''[/{''ID''}]]/'''Resource'''[/{''ID''}]]

NOTE: "v1" can be replaced with "v2","v3".

The "Resource" is the the name of the resource to be accessed (e.g. "device"). The "Property" used will be context dependent and is documented for each resource. Values are placed inside <nowiki>{}</nowiki> brackets. The brackets are used in the URI submitted.

In [[#Overview|URI Mode]], the Resource ID (e.g. "/''{ID}''") must be included unless it is the rightmost resource in the URI. In [[#Overview|JSON mode]], the ID is still required, but may be included in the submitted JSON instead.

Fields in <nowiki>[]</nowiki> brackets are optional on the URI, however, if they are required in the resource documentation, then they must be included '''either''' in the URI or in the JSON, but not both. The brackets themselves are not included in the URI submitted. Consider the following API call to retrieve the device name for device ID 1234:
'''URI Mode Request URI:'''
'''GET''' ''https://rest.sensaphone.net/api/v1/{987654}/{0123-4567-8901}/device/{1234}/name''
The ACCTID, SESSIONID, ID, and "name" fields may be excluded from the URI, but must then be included in the request JSON:
'''Request Description:'''
Retrieve the "name" property from device "1234".

'''JSON Mode Request URI:'''
'''POST''' ''https://rest.sensaphone.net/api/v1/device''

'''Request JSON:'''
{
"request_type:"read",
"resource":"device",
"acctid":987654,
"session": "0123-4567-8901",
"device": [
{
"device_id": 1234,
"name" : null
}
]
}

This will provide a response of the name of the device whose ID is "1234" for the account with ID 987654 using the Account ID of 987654 and Session ID of "0123-4567-8901":
'''Response JSON:'''
...
{
"device": [
{
"device_id": 1234,
"name" : "My Device"
}
]
}
...

The URI method is intended to allow quick access to single pieces of data, but using the JSON method is more complete and allows retrieval of multiple pieces of data at once.

===Additional Examples===
====POST====
'''Request Description:'''
Create a new alarm schedule for the device with ID 1234 and its zone with ID 112233.

'''URI Mode Request URI:'''
'''POST''' ''https://rest.sensaphone.net/api/v1/{ACCTID}/{SESSIONID}/device/{1234}/zone/{112233}/alarmschedule

====GET====
'''Request Description:'''
Retrieve the name of the zone with ID 112233 of the device with ID 1234.

'''URI Mode Request URI:'''
'''GET''' ''https://rest.sensaphone.net/api/v1/{ACCTID}/{SESSIONID}/device/{1234}/zone/{112233}/name

====PUT====
'''Request Description:'''
Change the name of the User with the ID 6778 to "John Doe".

'''URI Mode Request URI:'''
'''PUT''' ''https://rest.sensaphone.net/api/v1/{ACCTID}/{SESSIONID}/user/{6778}/name/{John Doe}''

====DELETE====
'''Request Description:'''
Delete the User with the ID 6778.

'''URI Mode Request URI:'''
'''DELETE''' ''https://rest.sensaphone.net/api/v1/{ACCTID}/{SESSIONID}/user/{6778}''

==JSON Format==
===Requests===
All requests using the JSON mode will only use the POST method with a "request_type" parameter.

All requests include one outer JSON object unless no request data is specified. Requests are made according the specific requirements of the resource being accessed. With the exception of the login page, a session ID must be included with all API requests. When using the [[#URI Syntax]] JSON mode, the following will be included:
{ ← All values must be within this outer JSON object.
"acctid":987654,
"session": "0123-4567-8901",
"request_type":"read", ← One of "read", "update", "create", "delete"
...
}

A resource is accessed as either a JSON array of objects or a JSON object. A resource's properties are listed in comma separated values in the JSON object for that resource. All JSON value types may be used. Resources within resources are accessed as JSON objects within objects (or Array of objects). The JSON type of a property is specified by the requirements for each resource.

When performing a '''Read''' on a resource, all properties will be returned if '''only''' the resource ID is specified. If one or more non-identifying properties are specified, only those properties will be returned. The data values for those ''specific'' properties should be 'null'.

When performing a '''Delete''', specified non-identifying properties to be deleted should have their data values set to 'null', just like in a '''Read'''.

When performing a '''Update''' or '''Create''', specified non-identifying properties to be set must have their data values set to valid types, '''not''' 'null'.

When performing a '''Update''', the identifying properties must be specified. You can't update a resource without identifying it.

When performing a '''Create''', the identifying properties of the resource being created should not be specified at all. Only existing resources can have identifiers already.

NOTE: Specifying properties that are not listed in the requirements has no effect.

'''JSON Mode Request URI:'''
'''POST''' ''https://rest.sensaphone.net/api/v1/device''

'''Request JSON:'''
{
"request_type":"read",
"resource":"device",
"acctid":987654,
"session": "0123-4567-8901", ← All values are within at least the outer JSON object.
"device":[ ← Devices are accessed as a JSON array of objects.
{
"device_id": 1234, ← The "device_id" property is provided to identify the device accessed.
"name": null, ← The "name" property is ''specifically'' requested, so it is set to null. The whole device will '''not''' be returned.
"zones":[ ← Zones are accessed as a JSON array of objects.
{
"zone_id": 112233 ← By only specifying the "zone_id" and no other properties, '''all''' zone data is requested.
}
],
"this fake property": "is ignored" ← Invalid properties are ignored.
}
]
}

The above request is equivalent to the following requests, but must be done in two steps because two pieces of data were requested (The device's name and the device's zone with the ID 112233). No request JSON is required in this case.
'''URI Mode Request URIs:'''
'''GET''' ''https://rest.sensaphone.net/api/v1/{ACCTID}/{SESSIONID}/device/{1234}/name''
'''GET''' ''https://rest.sensaphone.net/api/v1/{ACCTID}/{SESSIONID}/device/{1234}/zone/{112233}''

===Responses===
Responses conform to the following format and include error reporting.

{
"result":
{
"success": true, ← Overall result of the request.
"code": 0, ← Status code for overall result.
"message":"OK", ← String describing the overall result.

"properties": ← Optionally used for '''Create''', '''Update''', and '''Delete'''
{
"''PROPERTY''":{ ← Property names and layout will match the request.
"success": true,
"message":"OK",
"code":0
},
"''PROPERTY''":{
"success": false,
"message":"Failed",
"code":123
},
...
},
},
"response": ← Any data that may have changed ('''Create'''/'''Update'''/'''Delete''') or been requested ('''Read''').
{
...
}
}

The success, code, and message for the overall result will always be included. The data in the "response" JSON object will depend on the specification of the resource accessed in the original request, but will generally follow the same layout and format of the request, although the specific properties returned will vary.

'''JSON Mode Request URI:'''
'''POST''' ''https://rest.sensaphone.net/api/v1/device''

'''Request JSON:'''
{
"request_type":"update",
"resource":"device",
"acctid":987654,
"session": "0123-4567-8901",
"device":[
{
"device_id": 1234,
"name": "My Device", ← The device's "name" property is being changed.
"zone":[
{
"zone_id": 112233,
"name": 1234 ← The device's zone's "name" property is being changed.
}
]
}
]
}

'''Response JSON:'''
{
"result":
{
"success": true, ← The overall request was processed correctly, even if some properties had errors.
"code": 0,
"message":"OK",

"properties":
{
"device":[
{
"device_id": 1234, ← Identifying properties must be specified.
"name": { ← Property "name" was changed.
"success": true,
"message":"OK",
"code":0
},
"zone":[
{
"zone_id": 112233, ← Identifying properties must be specified.
"name": { ← The device's zone's "name" was changed.
"success": false,
"message": "A string type is required",
"code":123
}
}
]
}
]
},
},
"response":
{
"device":[
{
"device_id": 1234, ← Identifying properties must be specified.
"name": "My Device", ← The new value for the device's "name".
}
]
}
}

The above request is equivalent to the following requests, but must be done in two steps because two pieces of data were updated (The device's name and the device's zone's name). No request JSON is required in this case.
'''URI Mode Request URIs:'''
'''PUT''' ''https://rest.sensaphone.net/api/v1/{987654}/{0123-4567-8901}/device/{1234}/name/{My Device}''
'''PUT''' ''https://rest.sensaphone.net/api/v1/{987654}/{0123-4567-8901}/device/{1234}/zone/{112233}/name/{1234}''

The following are some of the status codes used for overall status.
::{{TableStart|border_size=1
}}{{TableRowN| '''Code''' | '''Description'''
}}{{TableRowN| 0 | Success
}}{{TableRowN| 1 | Failed: No Session ID provided
}}{{TableRowN| 2 | Failed: Session ID has expired
}}{{TableRowN| 3 | Failed: Invalid request URI.
}}{{TableRowN| 4 | Failed: Invalid request JSON.
}}{{TableRowN| 5 | Failed: Invalid username provided.
}}{{TableRowN| 6 | Failed: Invalid password provided.
}}{{TableRowN| 7 | Failed: User is not authorized.
}}{{TableRowN| 8 | Failed: Service unavailable. Try again later.
}}{{TableEnd}}

==Versions==
There will be three versions of the API. We will refer to them as V1, V2, and V3. The only difference between the versions is in the format of '''responses'''. Requests to the Sensaphone.net API are identical in all cases.

===V1===
V1 will primarily be used to give responses that will be directly displayed in a client's application.

'''Example V1 Response for "https://rest.sensaphone.net/api/v1/{987654}/{0123-4567-8901}/device/{1234}/name" :'''

{
"device": [
{
"device_id": 1234,
"name" : "My Device"
}
]
}

===V2===
V2 should be used when responses with the addition of metadata are needed.

'''Example V2 Response for "https://rest.sensaphone.net/api/v2/{987654}/{0123-4567-8901}/device/{1234}/name" :'''
{
"device": [
{
"device_id": 1234,
"name":
{
"is_null" : false,
"is_empty": false,
"value" : "Device 1",
"type" : "string",
"is_pending": false,
"is_ranged" : true,
"ranged":[
{
"null": false,
"min" : 0,
"max" : 128
}
]
}
}
]
}

::{{TableStart|border_size=1
}}{{TableRowN| '''Property''' | '''Status''' | '''Type''' | '''Description'''
}}{{TableRowN| is_null | Required | Boolean | States if the corresponding value is NULL. If so, no additional keys are given.
}}{{TableRowN| is_empty | Required* | Boolean | States if the corresponding value is empty. If so, no additional keys are given.
}}{{TableRowN| value | Required** | String | Description of the corresponding value
}}{{TableRowN| type | Required** | String | Type of value
}}{{TableRowN| is_pending | Optional | Boolean | States if the value is in process of being updated
}}{{TableRowN| is_ranged | Optional | Boolean | States if there is a set of ranges for the value
}}{{TableRowN| ranged | Optional | Array | Array of ranges
}}{{TableRowN| → null | Required | Boolean | States if the value can be null.
}}{{TableRowN| → min | Required*** | Mixed | Min of range
}}{{TableRowN| → max | Optional | Mixed | Max of range
}}{{TableEnd}}
::<nowiki>*</nowiki> Only required if "is_null" is false.
::<nowiki>**</nowiki> Only required if "is_empty" is false.
::<nowiki>***</nowiki> Only required if "null" is false.

===V3===
V3 should be used when only the pending meta data is needed

'''Example V3 Response for "https://rest.sensaphone.net/api/v3/{987654}/{0123-4567-8901}/device/{1234}/name" :'''

{
"device": [
{
"device_id": 1234,
"name" :
{
"is_pending": true
}
}
]
}

==Resources==
The following resources are accessible through the REST API. They may be accessible from different URI contexts. See the individual resource pages for more information.
::{{TableStart|border_size=1
}}{{TableRowN|'''Page''' |'''GET'''|'''PUT'''|'''POST'''|'''DELETE'''
}}{{TableRowN|  |(Read)|(Write)|(Create)|(Delete)
}}{{TableRowN|[[{{PAGENAME}}/login|login]] |Y|Y|Y|Y
}}{{TableRowN|[[{{PAGENAME}}/dashboard|dashboard]] |Y|N|N|N
}}{{TableRowN|[[{{PAGENAME}}/history|history]] |Y|N|N|N
}}{{TableRowN|[[{{PAGENAME}}/account|account]] |Y|Y|N|N
}}{{TableRowN|[[{{PAGENAME}}/device|device]] |Y|Y|Y|Y
}}{{TableRowN|[[{{PAGENAME}}/devicegroup|devicegroup]] |Y|Y|Y|Y
}}{{TableRowN|[[{{PAGENAME}}/address|address]] |Y|Y|N|N
}}{{TableRowN|[[{{PAGENAME}}/coordinates|coordinates]] |Y|Y|N|N
}}{{TableRowN|[[{{PAGENAME}}/zone|zone]] |Y|Y|Y|N
}}{{TableRowN|[[{{PAGENAME}}/calllist|calllist]] |Y|Y|Y|Y
}}{{TableRowN|[[{{PAGENAME}}/alarmschedule|alarmschedule]] |Y|Y|Y|Y
}}{{TableRowN|[[{{PAGENAME}}/schedule|schedule]] |Y|Y|Y|Y
}}{{TableRowN|[[{{PAGENAME}}/timerange|timerange]] |Y|Y|Y|Y
}}{{TableRowN|[[{{PAGENAME}}/contactgroup|contactgroup]] |Y|Y|Y|Y
}}{{TableRowN|[[{{PAGENAME}}/user|user]] |Y|Y|Y|Y
}}{{TableRowN|[[{{PAGENAME}}/contact|contact]] |Y|Y|Y|Y
}}{{TableEnd}}

===List===
The following is a list of all possible REST resources, excluding any possible '''<nowiki>[/Property/[/Value]]</nowiki>''' suffix. Properties ('''/Property''') of a resource are shown where it is a JSON object or array of objects (e.g. "alarmschedule"). For a full list of properties and values associated with each resource, see the page for that resource.
*/api/v1/login/{USERNAME}/{PASSWORD}
*/api/v1/{ACCTID}/{SESSIONID}/account
*/api/v1/{ACCTID}/{SESSIONID}/account/feature
*/api/v1/{ACCTID}/{SESSIONID}/calllist
*/api/v1/{ACCTID}/{SESSIONID}/contact
*/api/v1/{ACCTID}/{SESSIONID}/contact/schedule
*/api/v1/{ACCTID}/{SESSIONID}/contact/schedule/timerange
*/api/v1/{ACCTID}/{SESSIONID}/contactgroup
*/api/v1/{ACCTID}/{SESSIONID}/dashboard
*/api/v1/{ACCTID}/{SESSIONID}/device
*/api/v1/{ACCTID}/{SESSIONID}/device/default_schedule
*/api/v1/{ACCTID}/{SESSIONID}/device/default_schedule/timerange
*/api/v1/{ACCTID}/{SESSIONID}/device/default_schedule/calllist
*/api/v1/{ACCTID}/{SESSIONID}/device/device_schedule
*/api/v1/{ACCTID}/{SESSIONID}/device/device_schedule/timerange
*/api/v1/{ACCTID}/{SESSIONID}/device/device_schedule/calllist
*/api/v1/{ACCTID}/{SESSIONID}/device/feature
*/api/v1/{ACCTID}/{SESSIONID}/device/location
*/api/v1/{ACCTID}/{SESSIONID}/device/location/address
*/api/v1/{ACCTID}/{SESSIONID}/device/location/coordinates
*/api/v1/{ACCTID}/{SESSIONID}/device/zone
*/api/v1/{ACCTID}/{SESSIONID}/device/zone/alarm_zone/alarmschedule
*/api/v1/{ACCTID}/{SESSIONID}/device/zone/alarm_zone/alarmschedule/timerange
*/api/v1/{ACCTID}/{SESSIONID}/device/zone/alarm_zone/alarmschedule/calllist
*/api/v1/{ACCTID}/{SESSIONID}/device/zone/schedule
*/api/v1/{ACCTID}/{SESSIONID}/device/zone/schedule/timerange
*/api/v1/{ACCTID}/{SESSIONID}/devicegroup
*/api/v1/{ACCTID}/{SESSIONID}/history
*/api/v1/{ACCTID}/{SESSIONID}/login
*/api/v1/{ACCTID}/{SESSIONID}/user
*/api/v1/{ACCTID}/{SESSIONID}/user/alarm_user/contact
*/api/v1/{ACCTID}/{SESSIONID}/user/alarm_user/contact/schedule
*/api/v1/{ACCTID}/{SESSIONID}/user/alarm_user/contact/schedule/timerange
*/api/v1/{ACCTID}/{SESSIONID}/user/alarm_user/schedule
*/api/v1/{ACCTID}/{SESSIONID}/user/alarm_user/schedule/timerange
*/api/v1/{ACCTID}/{SESSIONID}/user/site_user/address