News for hackers. Stuff that matters.
Re:Ask HN: What are the not-so obvious things to consider wh... by caseysoftware on Saturday November 18, 2017 @01:58PM (#15730160)
Two big questions:

* How do they handle deprecation?

At some point, they're going to realize that their API design is wrong, could be better, or could take advantage of new patterns, methods, or even customer usage patterns. As a result, they're going to have to restructure and potentially deprecate things. Do they handle it with transparency, honesty or even just make sure your stuff still works?

At Twilio, the 2008 endpoints have been deprecated for 5+ years but still work and - to the best of my knowledge - there's no sunset announced. Yes, all the examples, docs, sdks, etc encourage you to use the new endpoints but the old ones are there. Compare that to Facebook, Google, Twitter, etc which turn on and off APIs and break things with little regard for end users. Which leads to the second question..

* What's their business model?

If they make more money as you use the platform more, that's great! In biz speak, your interests are aligned! They're going to make sure you get started as quickly as possible, minimize downtime, and make sure that your stuff works now and forever. Once again, that's the Twilio model.

If you scale from 1 to 10 to 1M requests/day and they make the same amount of money (or none in many cases), then they're going to be less concerned if you can't make 1, 5, or even 10% of those calls. Even worse, if the API itself is primarily used for market penetration purposes (once again: Twitter), they may treat you as a free R&D group and let you do the exploration and prove the market before they step in.

* Early Twilio employee, current Okta employee, wrote a book on API Design

Re:Ask HN: What are the not-so obvious things to consider wh... by cnj on Saturday November 18, 2017 @04:33PM (#15730828)
I totally agree on the second point (business model alignment), however I believe that amount of requests does in a lot of cases not mean that your interests are aligned.

Examples:

* A REST API needs 3 calls for $foobar. A GraphQL API only needs 1 call. The vendor will loose money if they optimize their API in a way that you can make less calls.

* Some of your data does not frequently change. If you pay per request, you can save money by caching. However, that'll make your implementation more complex (esp. if the API is supposed to be used directly from mobile apps).

IMO it's better if the API provider can charge based on business metrics. E.g. Stripe charges based on payment volumne. It doesn't matter if you do 2 or 200 API calls to make a payment.

Re:Ask HN: What are the not-so obvious things to consider wh... by caseysoftware on Saturday November 18, 2017 @07:25PM (#15731513)
I started by saying "use the platform more" and went to API requests because that's the natural connection but you're right that the more proper phrasing should probably be "more successful with the platform"
Re:Ask HN: What are the not-so obvious things to consider wh... by newlyretired on Saturday November 18, 2017 @08:41PM (#15731771)
Also relevant to this platform -- if your business is more successful when your customers are more successful, and they tell you that, and together you can measure that... you might be in a good place.
Re:Ask HN: What are the not-so obvious things to consider wh... by joshribakoff on Sunday November 19, 2017 @02:32AM (#15732746)
With graphQL you have a concept of query complexity, you would base costs on complexity not number of API calls.
Re:Ask HN: What are the not-so obvious things to consider wh... by scarface74 on Saturday November 18, 2017 @03:13PM (#15730432)
Since you didn't mention your book probably because you didn't want to come off as spamming. I'll ask, what's the name of your book?
Re:Ask HN: What are the not-so obvious things to consider wh... by passenger on Saturday November 18, 2017 @03:40PM (#15730551)
I think the book is http://TheAPIDesignBook.com
Re:Ask HN: What are the not-so obvious things to consider wh... by vonseel on Saturday November 18, 2017 @05:43PM (#15731071)
Yea man click his profile.
Re:Ask HN: What are the not-so obvious things to consider wh... by fapjacks on Sunday November 19, 2017 @09:25AM (#15733991)
Hey that's awesome. I tell people about the Twilio API when people ask me about good APIs out there to learn from.