Good call. I wasn't terribly happy with the API as specified.  I've updated it to match your spec here.