Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 4 Next »

Registers a mobile device of either type iOS or Android to an account. Registration may optionally contain information about the device token for dispatch of push messages. This end point should be called once every time the mobile app is started.

 
Endpoint ID:4001
Method:POST
URL:

/mobile/device/registration/dp-key/{dp-key}

/mobile/device/registration/ext-key/{ext-key}/{ext-type}

 

 dp-key

dialogportal™ master key that uniquely identifies account to register mobile device with

 ext-key

External key that uniquely identifies account to register mobile device with

 ext-type

Type of external key

Request body:

JSON data with information about type of mobile device and optionally information about the device token for dispatch of push messages. Setting device ID will enable push messaging to the device.

Required fields
 

deviceType:

 Must be “iOS” or “Android”

Optional fields
 push:

Setting the “push” value to either true or false will turn push messaging on or off, but only if a device id has been previously registered. Valid for Android devices only

Example 1 – Register an iOS device but without push
{
	"deviceType": "iOS"
}
Example 2 – Register an iOS device with push
{
	"deviceType": "iOS",
	"deviceID": "671c6845e85b4873596fcee5da2f1bc25b2d038a710c12bf992"
}
Example 3 – Register an Android device with push
{
	"deviceType": "Android",
	"deviceID": "671c6845e85b4873596fcee5da2f1bc25b2d038a710c12bf992"
}
Example 4 – Turn off push messaging for an Android device
{
	"deviceType": "Android",
	"deviceID": "671c6845e85b4873596fcee5da2f1bc25b2d038a710c12bf992",
	"push": "false"
}


 

JSON data with information about the newly registered mobile device

Example 1 – iOS device was just successfully registered:
{
	"deviceID": "671c6845e85b4873596fcee5da2f1bc25b2d038a710c12bf992",
	"deviceType": "iOS"
}
Example 2 – Android device was just successfully registered:
{
	"deviceID": "671c6845e85b4873596fcee5da2f1bc25b2d038a710c12bf992",
	"deviceType": "Android",
	"push": "true"
}
Example 3 – Android device was just successfully registered without device id (no push messaging):
{
	"deviceType": "Android",
	"push": "false"
}
Example 4 – iOS device was just successfully registered without device id (no push messaging):
{
	"deviceType": "iOS"
}
Status codes:201

Mobile device was registered successfully

 303

Mobile device is already registered for the calling app and the specified account

 404

Account was not found

  • No labels