It requests the registration of new devices to the webservice, through POST.
When requesting the registration of a new device for registered users, Followzup creates the Device-ID and a pair of cryptographic keys (RSA) associated with the device. For anonymous users, Followzup also creates an anonymous User Code (User-ID).
Because the device does not yet exist, the request XML is encrypted with the APP (Interface-ID) public key, which is used only for new devices registrations.
Once registered, the APP receives the information of the new device (User-ID, Device-ID and RSA public key of the device), which must be stored in its local base. After registration, new requests must be encrypted with the public key of the device.
|id||Contains the identification of the Interface (APP), no encrypted (Interface-ID)|
|key||Contains the temporary AES key encrypted with the public key and encoded in Base64;|
|frame||Contains the XML request, encrypted with the temporary AES key and encoded in Base64.|
In response to the POST, the webservice returns the XML POST response, which should not mistaken with the XML request response, as described below. The POST response XML includes 3 tags:
<?xml version="1.0" encoding="utf-8"?> <followzup> <retcode>return-code</retcode> <retframe>xml-request-response</retframe> <retmd5>md5-hash</retmd5> </followzup>
<?xml version="1.0" encoding="utf-8"?> <followzup> <stp>stamp</stp> <eml>login</eml> <pwd>password</pwd> </followzup>
<?xml version="1.0" encoding="utf-8"?> <followzup> <uid>User-ID</uid> <did>Device-ID</did> <pub>public-key</pub> <mod>public-key-module</mod> <pux>public-key-index</pux> </followzup>
|7105||Invalid Stamp code|
|7999||Webservice under maintenance|