@BasePath /api/v1 @Summary Create opening @Description Creating a new job opening @Tags Openings @Accept json @Produce json @Param request body HandlerOpeningRequest true "Request body" @Success 200 {object} HandlerOpeningResponse @Failure 400 {object} ErrorResponse @Failure 500 {object} ErrorResponse @Router /opening [post].

@BasePath /api/v1 @Summary Delete opening @Description Deleting a new job opening @Tags Openings @Accept json @Produce json @Param id query string true "Opening identification" @Success 200 {object} HandlerOpeningResponse @Failure 400 {object} ErrorResponse @Failure 404 {object} ErrorResponse @Failure 500 {object} ErrorResponse @Router /opening [delete].

@BasePath /api/v1 @Summary List opening @Tags Openings @Produce json @Success 200 {object} ListOpeningResponse @Failure 500 {object} ErrorResponse @Router /openings [get].

@BasePath /api/v1 @Summary Show opening @Description Showing a new job opening @Tags Openings @Accept json @Produce json @Param id query string true "Opening identification" @Success 200 {object} HandlerOpeningResponse @Failure 400 {object} ErrorResponse @Failure 404 {object} ErrorResponse @Router /opening [get].

@BasePath /api/v1 @Summary Update opening @Description Updating a new job opening @Tags Openings @Accept json @Produce json @Param id query string true "Opening identification" @Success 200 {object} HandlerOpeningResponse @Failure 400 {object} ErrorResponse @Failure 404 {object} ErrorResponse @Failure 500 {object} ErrorResponse @Router /opening [put].