Tectia Server and an external application communicate by sending messages of form
<parameter>:<data>
.
The following parameters are valid in the communication (Tectia Server ignores all other parameters):
version:
number
Specifies the highest protocol version number understood by the sender. Currently,
the only accepted value is "1
".
request:
id
Specifies the request id. The id
is unique for any
ongoing requests the external application has not yet completed.
end-of-request:
id
Denotes the end of a request.
success:
[additional_info]
Denotes a positive response to a request. Including additional information in the data field is optional.
failure:
[additional_info]
Denotes a negative response to a request. Including additional information in the data field is optional.
Tectia Mapper Protocol is line-based; all messages between Tectia Server and an external application
are terminated with a linefeed character ("\n"
in ANSI C,
0x0A
in hex).