based on the principle of developer-first--putting your target developers’ interests ahead of all other considerations
By building on top of APIs that are designed with the developers’ interests at heart, you are able to save you and your developers a lot of work while laying down the building blocks for others to build on top of.
API-first design is about a series of best practices across companies and industries that prioritize a better developer experience (DX).
by using the RESTful API Markup Language (RAML) to describe them.
APIs used to be simply the technical ways that you achieved something in a business context, but now APIs have transformed into business drivers. Why? Businesses are looking to: