Every once in a while you will be in a position to solve the challenge of writing and maintaining a piece of professional technical documentation for your product REST API. Building an API is easy, right? Technically speaking it is. The biggest challenge comes when someone has to use your API for the first time. It is then when you figure out that no-one except for the development team understands what the heck is going on behind the scenes. To avoid this potential pitfall, I would like to share our personal experience with our product’s API for sending invoices – Envoice.
1. Planning
Businesses today have complex business processes which expand over different software systems. Today, the most used software systems are not the ones that are offering plenty of functionalities, but, rather, the ones that offer APIs and out of the box integrations with other popular services. Having said that, if you are planning your next venture or already developing a product you will need to spend some time to get the things sorted out and allow your customers to integrate your service as part of their eco-system. There are several aspects you need to consider when preparing for API development, including: https://goo.gl/ruv8hU #DataIntegration #ML
