6.6 GET ERN URL

6.6.1 Purpose

This command can be used by a DSP to request an Atom feed entry about a release for which the DSP is only in possession of a ReleaseId. The DSP shall call the web service address previously agreed between the record company or distributor and the DSP.

The syntax for this call is not prescribed. Below are two possible approaches, with base.url being the URL agreed between the record company or distributor and the DSP and xxx being the ReleaseId (typically a UPC) for which a URL is sought.

Example 1

 base.url/?releaseid=xxx

Example 2

base.url/releaseid/xxx

6.6.2 Syntax of reply

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

  • 200 (OK);

  • 202 (Accepted, which in this case means that the record company or distributor will add the requested NewReleaseMessage into the feed once the relevant metadata has been compiled);

  • 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 an Atom feed entry in accordance with Clause 7.

If the status code is 202, the web service shall add the relevant Atom feed entry into the queue of Atom feed entries that the relevant DSP has access to by the DSP using the GET ERN List call.

Search