• APIs are consumed by other software
• It is important to get the interface right
• In HTTP, the wrong paths, bodies, headers, etc can break apps
• In Java, the wrong interface means code doesn't compile
• Updating APIs is harder than updating inner details

6 / 31