Endpoints

Destinations

Performing a GET operation on /destinations will give you a list of valid MIDI devices on your system to use. Curl example, assuming you're running goseq with defaults:

curl localhost:4000/destinations

This returns ["IAC Bus 2","Bus 1"] on my Macbook with no outboard gear connected.

Control

Performing POST operations on /control or /control/<sequence ID will start/stop the master clock or the given sequence respectively. Examples:

curl -X POST -d "start" localhost:4000/control starts the master clock

curl -X POST -d "destroy" localhost:4000/control/3 stops and deletes the sequence with ID 3

curl -X POST -d "stop" localhost:4000/control/mySequence stops only the sequence with ID "mySequence"

Seq

Performing POST operations on /seq/<sequence ID will create or replace sequences. You must supply a sequence ID as goseq performs no ID generation. I decided to leave out ID generation so that UI designers/implementers could pursue whatever scheme they'd like (e.g. intstrument1-seq1 if you wanted a column oriented UI somewhat like Ableton Live). Example:

curl -X POST -d @sample_json/simple-seq.json localhost:4000/seq/my-sequence

You will need to edit the sample json files to change the designated output, pick whichever one you have an instrument connected to that was reported by the destinations endpoint.