Brad Jorsch (Anomie) wrote: >When api.php was basically the only API in MediaWiki, calling it "the API" >worked well. But now we've got a Parsoid API, Gabriel's work on a REST >content API, Gabriel's work on an internal storage API, and more on the >way. So just saying "the API" is getting confusing. > >So let's bikeshed a reasonably short name for it that isn't something >awful like "the api.php API". I'm horrible at naming.
For what it's worth, <https://www.mediawiki.org/wiki/API:Main_page> uses "Web API", as does <https://www.mediawiki.org/wiki/How_to_contribute>. Tim Starling wrote: >How about "the action API"? The fact that it is organised in a >hierarchy of actions distinguishes it from REST, which is organised as >a hierarchy of objects. The term "action" also distinguishes it from RPC. A quick count at <https://www.mediawiki.org/w/api.php> says that there are currently 52 &list=foo entries and 83 &action=foo entries. While these numbers are inflated due to installed extensions, I'm hesitant to present the MediaWiki Web API as an action API. Though you could perhaps argue that listing is just another action. I tend to agree with the view of others in this thread that simply saying "the [{MediaWiki (core), Web}] API" is usually sufficiently clear. MZMcBride _______________________________________________ Wikitech-l mailing list [email protected] https://lists.wikimedia.org/mailman/listinfo/wikitech-l
