6.2 GET ERN Message

6.2.1 Purpose

This command can be used by a DSP to request a NewReleaseMessage or PurgeReleaseMessage. The web service address for this call is the URL for the specific instance of the requested NewReleaseMessage. The DSP would typically have received this URL from an Atom feed entry.

6.2.2 Syntax of reply

The web service shall return one of the following standard HTTP status codes with their standard HTTP response code semantics:

  • 200 (OK);

  • 301 (Moved permanently);

  • 400 (Bad request);

  • 401 (Unauthorised);

  • 404 (Not found);

  • 500 (Internal server error); or

  • 503 (Service unavailable due to a temporary overloading or maintenance of the server).

Other standard HTTP status codes may be used as determined by the bilateral agreement between the record company or distributor and the DSP.

If the status code is 200, the web service shall also return to the calling web service client an XML file containing a valid NewReleaseMessage or PurgeReleaseMessageas defined in the appropriate part of the ERN standard. If the status code is 301, the web service shall also return to the calling web service client the correct URL.

Search