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 Scoop.it from: www.programmableweb.com
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