MusicBrainz Web Server Interface Points

(NeedsUpdating & NeedsCategorizing) or CandidateForDeletion ? -- murdos 2007-04-13 23:34:24

• I don't know the info below to update it, but I'm working on a page for the editing urls, and this seems the most likely place to link it in to ("that is, the URLs, " below...) - Some kind of resource like this is needed, even if we end up wiping all the below and someone rewrites/updates it. -- BrianSchweitzer 2007-08-16 21:06:32

Here we aim to document the various "fixed" ways in to the MusicBrainz web server - that is, the URLs, query string parameters, POST data parameters etc on which external things depend.

cdi_client

The old CDIndex client

mb_client

The default "@URL@" is "mm.musicbrainz.org:80".

 const char *scriptUrl = "/cgi-bin/mq_2_1.pl";

 /** 
  * Retrieve an artistList from a given Artist id 
  */
 #define MBQ_GetArtistById \
     "http://@URL@/mm-2.1/artist/@1@/@DEPTH@" 

 /** 
  * Retrieve an albumList from a given Album id 
  */
 #define MBQ_GetAlbumById \
     "http://@URL@/mm-2.1/album/@1@/@DEPTH@" 

 /** 
  * Retrieve an trackList from a given Track id 
  */
 #define MBQ_GetTrackById \
     "http://@URL@/mm-2.1/track/@1@/@DEPTH@" 

 /** 
  * Retrieve an trackList from a given TRM Id 
  */
  #define MBQ_GetTrackByTRMId \
     "http://@URL@/mm-2.1/trmid/@1@/@DEPTH@" 

See GetWebSubmitURL: http://<server>[:<port>]/bare/cdlookup.html?id=...&tracks=...&toc=....

mb_tagger

Not really server access paths, but link targets which can be used to invoke some action within the tagger.

 const char *loadLink = "#mbt_load";
 Pops up the "open file" dialog.

 const char *loadDirLink? = "#mbt_dirload";
 Pops up the "open directory" dialog.

 const char *loginLink = "#mbt_login";
 Shows the options window, tab #2 (login details)

 tag:/track-guid/:/album-guid/

 lookup:<fileid>

Now back to the server-side stuff.

"?mbt=1" is passed to any url containing "showalbum.html" or "showartist.html"

intro: /tagger/intro.html?mbt=1 donate: /tagger/donate.html

See CreateLoginPage: POSTs to /bare/login.html with arguments User, Password and url. Url is encoded using @Q@ and @A@.

GET /taglookup.html with args:

        mbt=1
        artist, album, track, tracknum, duration, filename
        trackid, artistid, trmid

logo = http://musicbrainz.org (regardless of server)

/newlogin.html?mbt=1

See CreateTRMPage: this is the locally-generated page. References:

  /brainz.css
  /images/mblookup-tag.gif
  /showartist.html?mbid=...
  /showalbum.html?mbid=...
  /showtrack.html?mbid=...
  lookup:<fileid>

tunepimp