Open source technology has made developer’s lives easier–simplifying API integration and development. With REST APIs, we can build highly scalable time-to-market enterprise apps. REST takes a few months versus years with SOAP. However, as technology evolves and matures, it also devolves with complexities that require documentation, collaboration, and standards (sophisticated code, test-driven development, API-first development). APIs should be customer centric.
We believe that it is important to focus on building simple APIs with more focus on how to structure your resources–allowing your applications to become more cooperative is key. Determining what the consumer wants to accomplish is critical. Hence, we like to highlight the importance of testing and getting feedback from the consumer post-API development.
Beyond the initial API development, we use tools to manage feedback, as well as to leverage data and insights to optimize versioning (scaling). This is an important piece of API development for your company. At Arrae, we believe that strong API development is done with clean code, or as we like to call it, “great development hygiene”. Great development hygiene is seeded in consistency.
Consistency is critical for development in general, and especially for APIs where thorough testing and accurate documentation–code samples, return parameters–can make or break your API. We believe that this documentation plays a key role in keeping your consumer happy, and this is the end goal: a happy customer.