api-doc and specs for timeslots controller