Construction of the POST Data

The header for the POST data should have the following format. Replace the items in bold with user- and command-specific information.

Content-Type: text/xml
X-Username: OpenSRS Username
X-Signature: MD5 Signature
Content-Length: Length of XML Document

Following this header should be one blank line followed by the XML document that contains the OpenSRS command data. The header combined with the XML makes up the packet that is sent to OpenSRS to execute your command.

Response Messages

The response is returned in the form of an XML document. Responses contain data that may be simple strings or lists of information.

Common fields

There are a few common fields that all responses share, regardless of the action to which they are responding. The following fields comprise a standard response message. Some actions only use standard response messages.

Parameter name



The protocol that is being used (XCP).


In the case of responses, this is always REPLY.


Response code (meaning is action-specific).


Response text (meaning is action-specific).


Indicates whether the command was successful. Returns 0 if not successful and 1 if the action was successful.

Optional fields

In addition, the structure may contain the following fields, depending on the specific action that was requested.

Parameter name



A hash that contains any specific parameters or attributes to be sent along with the action request.