TE
科技回声
首页24小时热榜最新最佳问答展示工作
GitHubTwitter
首页

科技回声

基于 Next.js 构建的科技新闻平台,提供全球科技新闻和讨论内容。

GitHubTwitter

首页

首页最新最佳问答展示工作

资源链接

HackerNews API原版 HackerNewsNext.js

© 2025 科技回声. 版权所有。

How APIs should be: Drop in keys, running in 1 minute

73 点作者 merijn481将近 13 年前

6 条评论

patio11将近 13 年前
Apropos of nothing: if one is making decisions based on estimates of probable conversion rates, my ballpark for "web page visitor -&#62; makes at least one API request" would be closer to 1/100th of 2% than to 2%. You're probably better off going for an intermediate conversion (<i>cough</i> get their email <i>cough</i>) and then selling them into using the API over time, since this is a thing that the best prospects won't exactly do on a lark.<p>(I am unsure of whether I like the make-a-play-in-the-browser-utility suggestion from the perspective of the business. I have never work directly on that question for a client, so I don't have even anecdata for y'all on this, but the developer in me says "That's a great idea! That way I don't have to do any work to kick the tires." and the marketer in me says "If we sold 'tire kicking' that would be wonderful now wouldn't it")
评论 #4049851 未加载
saurik将近 13 年前
&#62; The bottom line is that the single most important step in converting developers to permanently use your API in their product is how easy it is for them to get started after they sign up.<p>I take issue with this. If the single most important step to converting developers to /permanently/ using your API isn't something like scalability, security, performance, or functionality, there is something wrong with this world.<p>Just because you get more people to succeed in trying your API at the beginning, if it doesn't work for their use case over the long haul they are just going to leave and do something else: the key word is then "permanently".<p>In comparison, Amazon's APIs are often ludicrously complex. Even if you try to use Amazon's client libraries, they are often ludicrously complex, requiring you to construct object factories to get arguments even for the most common request paths.<p>But, by and large, Amazon's services don't stop working when you get too much data, have well-thought-out authorization mechanisms, have never become randomly slow as lots of users sign up for the service, and are sufficiently flexible to support many different kinds of tasks.<p>The fact that the first time I sat down and used Amazon's APIs it took me a while to get them working (and that some APIs from them I still haven't gotten around to learning all the properties of) is then irrelevant: I could tell they would do what I wanted once I figured it out, and I have never been disappointed.<p>Meanwhile, I've come across tons of random startups, often that have websites that are a "little too Web 2.0" (normally a negative indication for an API provider, btw), whom have APIs (or libraries, or daemons, or services, or programming languages) that are great at first but actually sucked.<p>(I mostly felt the need to make this comment, btw, due to someone else in this thread seemingly arguing against OAuth because, despite being secure, it made the API sufficiently complex that they could no longer use curl with it: that is the opposite method from how you should be choosing an API.)
zubairov将近 13 年前
Good points are covered in this blog post, however what if we would push it even further?<p>Why would people need to download a package? Why would anybody need to learn a programming language you package designed for (or assume you distribute packages for many programming language)?<p>When using APIs for integration or mashups, especially in business world, person who know how solution should looks like may not have time to code. So we at <a href="http://elastic.io" rel="nofollow">http://elastic.io</a> think API could be via visual designer.<p>We believe it's also a way to make API usage _simpler_ for enduser, even the one who can not, or have no time to code.
评论 #4049306 未加载
评论 #4048681 未加载
arethuza将近 13 年前
I now know how I like Web APIs to work: Give me the URL and let me go at it with cURL and some scripts to parse the your JSON.<p>[Been using the Salesforce REST API recently, and apart from the process of getting your OAuth token, it's really rather good].
评论 #4048734 未加载
DanLivesHere将近 13 年前
FYI this is the same org which is running the $10K app challenge using their API this weekend; <a href="https://singly.com/appchallenge" rel="nofollow">https://singly.com/appchallenge</a>
merijn481将近 13 年前
Re-posted to the Factlink blog at <a href="http://blog.factlink.com/" rel="nofollow">http://blog.factlink.com/</a>