Earlier quoted context omitted.
Top APIs I've enjoyed working with: 1. Stripe (Best) 2. Twilio 3. Twitter (Does what it needs to do quickly) 4. Puppeteer (Amazing. Was super helpful.) 5. Google (mostly ok but could be better) APIs I've hated working with: 1. Paypal (the worst - docs are horrible and UI is not consistent with most of the help material out there because it changes all the time. Have you tried their support? That's a beauty) 2. Facebo…
The Twilio Dashboard _really_ needs a refresh. It's still in a world where every button is a complete page refresh. It's painfully slow to interact with.
Stripe CLI
101–110 of 149 posts
Re: Stripe CLI
#102Earlier quoted context omitted.
Add eBay to the second list. We are still uploading XML documents.
And Amazon sellers API (Amazon MWS). Rarely seen such an inconsistent mess of often poorly documented SOAP-ish calls, that so many external partners base their livelyhood on.
This actually explains a lot of other things. Like the DMV.
Re: Stripe CLI
#103In the Twilio world, I can do something like this, via the command line and their API: - activate new phone number - send SMS from that number - deactivate number I have not ever done that particular workflow , but I could. Who is the Twilio of payments/fintech wherein I could perform a workflow like this: - generate new CC number in my name - set transaction limit(s) and expiry 10 days from now - (go use that CC in…
How could you programmatically create a credit card without some pre-existing financial relationship with a a credit card issuer? There's a good reason you cannot simply create and destroy payment cards without any trusted third party keeping track. Money laundering is the obvious issue.
Re: Stripe CLI
#104In the Twilio world, I can do something like this, via the command line and their API: - activate new phone number - send SMS from that number - deactivate number I have not ever done that particular workflow , but I could. Who is the Twilio of payments/fintech wherein I could perform a workflow like this: - generate new CC number in my name - set transaction limit(s) and expiry 10 days from now - (go use that CC in…
Re: Stripe CLI
#105Earlier quoted context omitted.
Top APIs I've enjoyed working with: 1. Stripe (Best) 2. Twilio 3. Twitter (Does what it needs to do quickly) 4. Puppeteer (Amazing. Was super helpful.) 5. Google (mostly ok but could be better) APIs I've hated working with: 1. Paypal (the worst - docs are horrible and UI is not consistent with most of the help material out there because it changes all the time. Have you tried their support? That's a beauty) 2. Facebo…
Add eBay to the second list. We are still uploading XML documents.
Re: Stripe CLI
#106Stripe is by far the best developer experience I’ve had in my career working with third party APIs/services. The attention to detail is just second to none, and documentation is a big part of this.
Aside from documentation, how do you judge if an API is good?
1. Simple, distinct concepts with unambiguous names.
2. Semantics are clear, following conventions as appropriate.
3. Minimize surface area without reducing functionality.
4. Clarity and specificity of ErrorCodes and messages.
= Operational characteristics =
1. Extremely low level of 500s.
2. Low call latencies.
3. The API does what it says it does.
4. Consistency is (nearly) always within its documented SLA.
5. Do not make backwards incompatible changes.
= Social characteristics =
1. Docs are correct, up-to-date, complete, specific, and unambiguous.
2. Clearly communicate service outages and resolution timelines.
3. Seek feedback on evolving the APIs.
Re: Stripe CLI
#107Stripe is by far the best developer experience I’ve had in my career working with third party APIs/services. The attention to detail is just second to none, and documentation is a big part of this.
Top APIs I've enjoyed working with: 1. Stripe (Best) 2. Twilio 3. Twitter (Does what it needs to do quickly) 4. Puppeteer (Amazing. Was super helpful.) 5. Google (mostly ok but could be better) APIs I've hated working with: 1. Paypal (the worst - docs are horrible and UI is not consistent with most of the help material out there because it changes all the time. Have you tried their support? That's a beauty) 2. Facebo…
Re: Stripe CLI
#108Stripe is by far the best developer experience I’ve had in my career working with third party APIs/services. The attention to detail is just second to none, and documentation is a big part of this.
Top APIs I've enjoyed working with: 1. Stripe (Best) 2. Twilio 3. Twitter (Does what it needs to do quickly) 4. Puppeteer (Amazing. Was super helpful.) 5. Google (mostly ok but could be better) APIs I've hated working with: 1. Paypal (the worst - docs are horrible and UI is not consistent with most of the help material out there because it changes all the time. Have you tried their support? That's a beauty) 2. Facebo…
Re: Stripe CLI
#109Earlier quoted context omitted.
Top APIs I've enjoyed working with: 1. Stripe (Best) 2. Twilio 3. Twitter (Does what it needs to do quickly) 4. Puppeteer (Amazing. Was super helpful.) 5. Google (mostly ok but could be better) APIs I've hated working with: 1. Paypal (the worst - docs are horrible and UI is not consistent with most of the help material out there because it changes all the time. Have you tried their support? That's a beauty) 2. Facebo…
I was shocked at how bad the documentation for Facebook was. I assumed wiring up login would be super simple, it’s amazing how hard it was to find in their documentation. I guess when you’re paying devs to implant a shitty custom currency you can’t invest in docs for one of your biggest integrations.
They have no incentive to improve their docs. They're Facebook, there's no competition at all.
Re: Stripe CLI
#110Earlier quoted context omitted.
Thanks! We still have a lot of work to do. (Making our integration experience simpler -- now that Stripe's functionality has grown so much -- is an area of current focus. If any HN readers happen to have specific suggestions on this front, feel free to email sebas@stripe.com.)
I love the backwards compatibility that Stripe provides. Thank you so much! We launched a SaaS product on the 2016-03 API version. Since then[1] the API has basically changed completely around subscriptions (even the top-level objects aren't called the same anymore), to the point it would probably be easiest to just start a rewrite from scratch (which probably would take a week or two). But the fact that the old API…