Determining What Makes a Good API
From APIDesign
(Difference between revisions)
(→Everything) |
|||
| (4 intermediate revisions not shown.) | |||
| Line 1: | Line 1: | ||
== Have You Ever Wondered...? == | == Have You Ever Wondered...? == | ||
| - | Have you ever searched for the root reason why some of | + | Have you ever searched for the root reason why some of [[API]]s you liked more than others? Are those APIs that you liked the most also those most easily usable? I was thinking about this a lot. First of all I broaden the meaning of the term API and let |
| - | + | [[Determining What Makes a Good API|the chapter 3]] define what it means an [[API]], explain why and enumerate various [[APITypes]]. Then I also look at the basic objective criteria to ensure an API is really good, that it is an example of [[Good Technology]]. | |
| + | |||
| + | == Everything == | ||
| + | |||
| + | The shortest answer to the question "What is an [[API]]?" is: ''Everything somebody else can depend on''. The emphasis in the previous sentence is being placed on '''can''' - it is not used in the meaning of ''may''! As grandma used to reply: Can I go out? ''Sure, you can. But you may not!'' | ||
Current revision
Have You Ever Wondered...?
Have you ever searched for the root reason why some of APIs you liked more than others? Are those APIs that you liked the most also those most easily usable? I was thinking about this a lot. First of all I broaden the meaning of the term API and let the chapter 3 define what it means an API, explain why and enumerate various APITypes. Then I also look at the basic objective criteria to ensure an API is really good, that it is an example of Good Technology.
Everything
The shortest answer to the question "What is an API?" is: Everything somebody else can depend on. The emphasis in the previous sentence is being placed on can - it is not used in the meaning of may! As grandma used to reply: Can I go out? Sure, you can. But you may not!
Follow
