Answer the question
In order to leave comments, you need to log in
Answer the question
In order to leave comments, you need to log in
RAML (youngest, but recommended)
Swagger
Apiary
These are frameworks for designing APIs. In fact, they provide their own DSL for describing and DOCUMENTING (!) API. Most of them come with tools for generating readable docks and all sorts of mock tools and generators of load clients and stub services (for testing services and clients, respectively). Here is an example of tools for Swagger: swagger.io/swagger-codegen :
vREST is a more complex product that includes test automation, there are paid options.
Mashape is a great API product, used by many large companies (eg Blizzy uses it).
PS There are also various models of hypermedia APIs ( JSON-LD , HAL , Siren , etc.), but these are not very popular things yet, so if you are not ready to be one of the pioneers, it is better to try them later when they gain popularity (if pick up).
at the moment, everyone comes up with their own "api language" to describe their services, as there is no certainty what functionality and how you want to show through api.
Didn't find what you were looking for?
Ask your questionAsk a Question
731 491 924 answers to any question