This API defines the web service call device manufacturers need to call when registering a device controller in the Arghon ecosystem..
Click here for XSD Specification file
This is the arghon developer key you received when you created an Arghon developer account.
If supplied, the arghon_authentication_id will be sent in all control requests. This is used by web-services to authenticate the system making the request.
If supplied, the arghon_authentication_password will be sent in all control requests. This is used by web-services to authenticate the system making the request.
An identifier that allows you to identify the device in your system.
This ID will be sent in all control requests.
The parent_deviceid allows you to group sub controls to a parent. The ID in deviceid field belongs to the sub control.
An example of sub control would be the garage door in a home security system.
parent_deviceid=ADT
deviceid=garage_door.
A name that will be displayed to the user when the user is configuring the control of this device.
The fully qualified URL to your web-service where all control requests will be sent.
Note: This URL must use HTTPS or the registration will fail.
An optional fully qualified URL to an image of the device.
A short description of the device. This helps the user determine if they are setting up the correct device.
The features this device can handle. If more than 10 are included the first 10 will be supported.
See the list of control feature codes in the XSD file.
If set to 1 the Arghon user must supply an account ID when setting up the device. The account id will be sent in all control requests.
All devices that requires_user_account_id and requires_user_account_password will require verification by Arghon personnel before the service is available to Arghon users.
If set to 1 the Arghon user must supply an account password when setting up the device. The account id will be sent in all control requests.
All devices that requires_user_account_id and requires_user_account_password will require verification by Arghon personnel, before the service is available to Arghon users.
If set to 1, the Arghon user must supply the device's serial number when setting up the device.
The serial number will be sent in all control requests.
If set to 1, the device will be made inactive and not be available to users.
Set this value to 1 to remove the device form active use
See XSD documentation for list of registration error codes.
A text message that explains the error.
This field will be set to 1 if your device does not require the user enter a userid and password. If a user id and password is required and "controller_url" belongs to the same domain as the developer userid, then it will also be authenticated.
If authenticated is 0 you will need to contact our support department at tech_support@arghon.com to authenticate the device. All devices must be authenticated before they are available to our users.
The URL to use when registering a control in the Arghon Ecosystem:
https://arghon.com/rebel/registercontroller/ HTTP POST