The best way to design a REST API is with a specification. Common REST API specifications include OpenAPI, RAML, and API Blueprint. The different styles may be important because some design tools favor a certain style, but you can often find ways to convert between the different formats.