REST web service APIs

We've discussed the idea of using iToolkit for Node.js to invoke SQL
statements, commands, programs, and procedures on IBM i. I'm going to
suggest an alternative.

How many web developers are familiar with the "openAPI specification" or
"OAS", and tools like Swagger that assist in designing, building,
documenting, and testing REST web-service APIs?

https://swagger.io/

Rather than invoking iToolkit functions in JavaScript, all client
applications (whether Node or whatever) "request" IBM i services via common
URLs and HTTP put, post, get, and delete methods. For example:

post /pet - Add new pet to pet store.
put /pet - Update existing pet.
get /pet/{petID] - Get pet record by ID.
delete /pet/{petID} - Delete pet record by ID.

Request and responses encapsulate JSON structures such as:

{
"id": 0,
"category": {
"id": 0,
"name": "string"
},
"name": "doggie",
"photoUrls": [
"string"
],
"tags": [
{
"id": 0,
"name": "string"
}
],
"status": "available"
}

Does anyone else see advantages to this approach?