/track_match_request

afterpageloadcalls

Add tracks to your trackset

Endpoint https://api.musicxray.com/track_match_requests.xml

You must have first created a track set and at least one track to use this resource

Track matching is a process that can take a relatively large amount of time and is thus an asynchronous process. The idea is that you tell our application to to generate matches. Instead of polling our application, we tell your application when the request is complete. This allows for a more event driven architecture and less wasted bandwidth.

Supported methods

  • /track_match_requests.xml [GET,POST]
  • /track_match_requests/[resource_id].xml [GET]
  • /track_match_requests/[resource_id]/rematch.xml [PUT]

Properties

name description type access required example value
id UNIQUE id Integer read-only yes 1,2,3
result_delivery_method How should we notify when your matches are ready String read,write yes One of the following [none,postback]
post_back_url publicly accessible url to notify when results are ready String read,write yes http://url.com/song/12/result_ready
track_set_id UNIQUE id of track set to match too Integer read,write yes 1,2,3....
track_id UNIQUE id of track to match Integer read,write yes 1,2,3...