It’s easy to think that an API is either well designed or poorly designed, and that objective perfection is within striking distance. But the real world is a chaotic place.

Sourced through from:

Stripe is known to have a good approach to flexibility and versioning in API design. This guest article on ProgrammableWeb describes 3 lessons learned from their Stripe Connect API:

Lesson #1: If you require an integrator to build some capability, verify that it’s in place before allowing them to launch

Lesson #2: Minimize requirements

Lesson #3: Always be improving — if not the API, then the documentation

Why It’s OK To Design Imperfect APIs
Tagged on:         

Leave a Reply

Your email address will not be published. Required fields are marked *

You may use these HTML tags and attributes: <a href="" title=""> <abbr title=""> <acronym title=""> <b> <blockquote cite=""> <cite> <code> <del datetime=""> <em> <i> <q cite=""> <s> <strike> <strong>