User Tools

Site Tools


en-138-app-resp


APP Request / RESP

The RESP command requests the webservice, through POST, to send a response message to the application related to the channel.


POST variables

id Contains the identification of the Device, no encrypted (Device-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.



XML POST response

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>

where:

  • retcode: Return code of the requested command represented by 4 numeric digits or “0” (zero) for successfully execution;
  • retframe: Contains the XML request response, encrypted with the temporary key AES and encoded in Base64. The XML request response depends on the command that was requested and the AES key used in its encryption is the same were used when the request was sent;
  • retmd5: Contains the MD5 hash of the retframe tag, to be validated by the requester.



XML request

<?xml version="1.0" encoding="utf-8"?>
<followzup>
<stp>stamp</stp>
<com>resp</com>
<seq>sequence</seq>
<chn>channel-tag</chn>
<mor>response</mor>
</followzup>

Where:

  • stamp: Stamp code of the Interface.
  • resp: Must contain the literal “resp” (Send Message Response);
  • sequence: Contains the request sequence number.
  • channel-tag: Tag of the channel to send a message response;
  • response: Message response up to 60 characters (BASE64 format).



XML request response

  • (null)


XML request response (invalid sequence):

<?xml version="1.0" encoding="utf-8"?>
<followzup>
<seq>Last-sequence</seq>
</followzup>

Where:

  • Last-sequence: Sequence number used in the last request.



Return codes

0 Successfully execution
7101 Invalid sequence
7102 Invalid frame
7103 Invalid command
7104 Invalid Device-ID
7272 Message is null
7273 Invalid channel
7999 Webservice under maintenance


en-138-app-resp.txt · Last modified: 2017/05/30 12:10 by admin

Page Tools