Description
I've just realized that what people call Web Services, it is named "Joomla API" and the naming inconsistency is general.
Since "Joomla API" can refer to any API in Joomla (For instance, the Joomla Platform API), it would be great if we can avoid confusions naming web services as "Web Services". For more info about the definition of API as "application programming interface" https://en.wikipedia.org/wiki/API
Please, check the following inconsistencies between the official channels and the "Web Services" / "Joomla API" feature.
Joomla 4 tutorial: Using the Web Services API
https://www.youtube.com/watch?v=lT9qodsvfZg
Joomla! Api
https://docs.joomla.org/Category:Joomla!_Api
J4.x:Adding an API to a Joomla Component
https://docs.joomla.org/Category:Joomla!_Api
Joomla Api Specification
https://docs.joomla.org/Category:Joomla!_Api
J4.x:Joomla Core APIs
https://docs.joomla.org/J4.x:Joomla_Core_APIs
Joomla Web Services API 101 - Tokens, Testing and a Taste Test
https://magazine.joomla.org/all-issues/august-2020/joomla-web-services-api-101-tokens,-testing-and-a-taste-test
Web Services Working Group
https://docs.joomla.org/Web_Services_Working_Group
On Joomla 4, there are plugins named:
- Web Services - Banners
- API Authentication - Basic Auth
- API Authentication - Joomla Token
In this case, it is not clear if all Joomla APIs of any kind are restricted with authentication, or only the Web Services are restricted with the "api-authentication" plugins.
So, it would be great if we settle to name web services as Joomla "Web Services" and remove all references to "Joomla API" or "API" to refer to "Web Services". In this way, the Joomla usage of the term "Web Service" will be close to the general usage of the concept. For more information about the "Web Service" term: https://en.wikipedia.org/wiki/Web_service