4. The goal
▪ Set interfaces and nomenclatures
▪ Define input and output
▪ Define error codes and responses
APICONF 2017 – Gabriele Mittica
5. The problem
▪ It’s a long job
▪ List endpoints is not enough
▪ I need to put business logic in to documentation
APICONF 2017 – Gabriele Mittica
6. How to
▪ Doc-driven and test-driven development
▪ Explain business logic
▪ Declare versioning and growth of APIs
▪ Don’t create doc by layout but by logic
APICONF 2017 – Gabriele Mittica