A payload error is generated if a request payload is illformed. If such
an error occurs, all the requests contained in the payload are ignored. In
the case of an error, the Search Engine Server returns a response payload
containing a single ses-response
element. Instead of the
request-id
attribute the opening tag of this element contains
a payload-id
attribute whose value is the ID of the invalid
payload.
The ses-response
element contains an ses-code
element in whose opening tag the attributes numeric
and
phrase
are set to the error number and the message text,
respectively. The following example shows a response payload containing an
error message.
<?xml version="1.0" encoding="UTF-8"> <!DOCTYPE ses-payload SYSTEM "http://www.example.com/ses.dtd"> <ses-payload payload-id="B3BWPOIU" timestamp="20100906100205" version="2.1"> <ses-header> <ses-sender sender-id="U2JWUE09" name="SES"/> </ses-header> <ses-response response-id="BR12TI5X" payload-id="AHZ97I28" success="false"> <ses-code numeric="1" phrase="Payload incomplete / cannot parse"> </ses-code> </ses-response> </ses-payload>
On the payload level the following errors can occur:
ses-authentication
element is invalid.