The best APIs are simple web standards



“For example, consider a reader’s annotations or comments on a New York Times article; any comments penned in single page mode should appear on the paginated version, where an article spans by default two, three, or four separate web pages, even though the web URLs are different for each page. The Times makes this easy because they use a common standard promulgated by Google and other search engines called a “canonical url,” which is now an IETF RFC.”