APIs are interfaces, just like UIs. But while a website or a mobile app is designed to be used by a consumer, an API has two very specific audiences in mind: other systems, and the programmers who build them.
A well-designed API can make or break an application. So how do developers build great APIs? What design principles should be followed? We will discuss these questions based on the work of thinkers in the areas of industrial design, writing, and a product development theory.
28. While freely conceding that the Soviet
regime exhibits certain features which
the humanitarian may be inclined to
deplore, we must, I think, agree that a
certain curtailment of the right to political
opposition is an unavoidable
concomitant of transitional periods, and
that the rigors which the Russian people
have been called upon to undergo have
been amply justified in the sphere of
concrete achievement.
29. I am not, indeed, sure whether it is not
true to say that the Milton who once
seemed not unlike a seventeenth-century
Shelley had not become, out of an
experience ever more bitter in each year,
more alien to the founder of that Jesuit
sect which nothing could induce him to
tolerate.
Harold Laski, Essay in Freedom of Expression
30. I am not, indeed, sure whether it is not
true to say that the Milton who once
seemed not unlike a seventeenth-century
Shelley had not become, out of an
experience ever more bitter in each year,
more alien to the founder of that Jesuit
sect which nothing could induce him to
tolerate.
31. I am not, indeed, sure whether it is not
true to say that the Milton who once
seemed not unlike a seventeenth-century
Shelley had not become, out of an
experience ever more bitter in each year,
more alien to the founder of that Jesuit
sect which nothing could induce him to
tolerate.
32. 1. Never use a metaphor, simile,
or other figure of speech which
you are used to seeing in print.
33. 2. Never use a long word where a
short one will do.
34. 3. If it is possible to cut a word
out, always cut it out.
35. 4. Never use the passive where
you can use the active.
36. 5. Never use a foreign phrase, a
scientific word, or a jargon word if
you can think of an everyday
English equivalent.
37. 6. Break any of these rules sooner
than say anything outright
barbarous.
68. HTTP/1.1 401 Unauthorized
{
"errors": [
"api_key not found. Please log in to https://
example.com/account/api to retrieve your API
key.",
"api_key may not include spaces."
]
}