RestaPI v3: second batch of fixes for swagger doc