Slide 1

Slide 1 text

API Design Lifecycle Collaborating to Build Great APIs

Slide 2

Slide 2 text

– Leslie Lamport “I believe that the best way to get better programs is to teach programmers how to think better.”

Slide 3

Slide 3 text

Architecture is related to a set of (self- imposed) constraints that produce a set of favorable properties of a system

Slide 4

Slide 4 text

Design First • Include variety of stakeholders • Top-down vs. bottom-up • Develop good designs early • Re-usable description format as contract • Write less code

Slide 5

Slide 5 text

The best design of an API is not a particular paradigm or architecture – it is a design where everybody at the table agreed on what the API is/will be.

Slide 6

Slide 6 text

Prototyping • Collaborative • Realtime mocking • Code Generation

Slide 7

Slide 7 text

Implementation • Parallel Client/Server Development • TDD/BDD/CI Integration

Slide 8

Slide 8 text

Documentation • Auto-generated • Interactive • Validated in CI

Slide 9

Slide 9 text

Monitoring • Post-deployment Smoke Testing • Debugging • Inspection

Slide 10

Slide 10 text

Mark W. Foster [email protected] @fosrias @apiaryio We’re Hiring! http://docs.pollsdemoapi.apiary.io