microlib / org

General organisation repository
0 stars 0 forks source link

Evaluate use of API language #2

Open marcotroisi opened 7 years ago

marcotroisi commented 7 years ago

There are quite a few "API language" specifications, the most popular ones being API Blueprint and Swagger/OpenAPI.

Perhaps the best thing about using any of those tools is having a nice standard for writing and designing our API endpoints, with several tools built around them (i.e. Dredd for testing).

Downside might be a bit of extra work at the beginning.

Opinions are welcome.

marcotroisi commented 7 years ago

A PoC for this has been created for the usermanager https://github.com/microlib/usermanager/issues/27