Brief introduction into HTTP RESTful API design, plus some practical issues we hit when designing APIs for Aeolus project and how we solved them.