Define API methods, requests and responses. We can use Apiary or their open source project: https://github.com/apiaryio/api-blueprint