The central thesis here is that APIs should be treated like GUIs. Make them as intuitive as possible to minimize brain space waste (ie. memorization of non-transferable, vendor-specific knowledge)
Sadly, the post is too short to discuss what "intuitive" means for an API (which could probably fill several volumes).
Sadly, the post is too short to discuss what "intuitive" means for an API (which could probably fill several volumes).