Ask HN: Is there a model for a healthy, long-term API policy

  • This really depends on the type of business behind the API. Transactional API models have worked really well (Expedia affiliates, payment gateways, messaging). It's really only been a problem for providers who didn't properly align their interests with the consumer of the API meaning one side of the equation was getting far more value than they were contributing. This tends to be most common in consumer service APIs.

    I wrote a little bit about this here: http://thenextweb.com/dd/2013/03/12/apis-are-dead-long-live-...

  • To see a model for this, look to companies with B2B DNA. Facebook and Twitter are used to taking a "PM knows best" b2c approach, not a "customers first" perspective. Salesforce REST is a good example from larger companies (disclosure - my cofounder was one of it architects), and Stripe's API is a great example from the startup world.

    From studying these, I found that the best practices aren't all that surprising: versioning, discoverability, and following HTTP standards.