Designing our REST API using Swagger