Why avoid Web APIs for micro-service integration?

• Web APIs do not issue compilation errors (syntax and/or types)
• Web APIs commit you to a hard boundary between micro-services, difficult to change subsequently
• Web APIs do not let you pass objects or closures as arguments
• a toy case study: reminder manager

It is best to avoid Web APIs for internal-facing APIs.

When to use Web APIs? Web APIs are ideal for external-facing APIs:

• they are language-agnostic
• they discourage stateful interaction
• they set stronger security boundaries