24.02.2015 Views

Specification - RETS

Specification - RETS

Specification - RETS

SHOW MORE
SHOW LESS

You also want an ePaper? Increase the reach of your titles

YUMPU automatically turns print PDFs into web optimized ePapers that Google loves.

S ECTION<br />

0GETOBJECT TRANSACTION<br />

CHAPTER<br />

The GetObject transaction is used to retrieve structured information related to known<br />

system entities. It can be used to retrieve multimedia files and other key-related<br />

information. Objects requested and returned from this transaction are requested and<br />

returned as MIME media types. The message body for successful retrievals contains only<br />

the objects in the specified MIME media type. Error responses follow the normal response<br />

format (section 3.9).<br />

5.1 Required Client Request Header Fields<br />

In addition to the Required Client Request Header Fields specified in Section 3.3, the<br />

header of any messages sent from the client MUST contain the following header fields:<br />

Accept<br />

The client MUST request a media type using the standard HTTP<br />

Accept header field. Media-type formats (subtypes) are registered<br />

with the Internet Assigned Number Authority (IANA) and use a<br />

format outlined in RFC 2045 [8]. When submitting a request the<br />

client MUST specify the desired type and format. If the server is<br />

unable to provide the desired format it SHOULD return a “406<br />

Not Acceptable” status. However, if there are no objects of any<br />

subtype available for the requested object the server SHOULD<br />

return “404 Not Found.” The format of the Accept field is as<br />

follows:<br />

Accept ::= Accept: type / subtype [ ; parameter ]<br />

*( , SP type / subtype [ ; parameter ])<br />

type ::= * | <br />

subtype<br />

::= * | <br />

parameter ::= q = < qvalue scale from 0 to 1 ><br />

A complete list of media types and subtypes is available at:<br />

http://www.iana.org/assignments/media-types/<br />

Version 1.7.2 5-1

Hooray! Your file is uploaded and ready to be published.

Saved successfully!

Ooh no, something went wrong!