An RDAP capability for server specification provisioning
8th ROW - Bangkok, May 9th, 2019
An RDAP capability for server specification provisioning
Mario Loffredo, Maurizio Martinelli IIT-CNR/Registro.it
mario.loffredo,maurizio.martinelli@r.it
Content
REST API Specification languages
RDAP
? Servers ? Clients ? Client-Server interaction
Proposal
? Goals ? Implementation
? Server ? Client
? Advantages ? Registro.it implementation
Q&A
REST API Specification languages (1)
There is a growing consensus that modern REST APIs should be self-descriptive
A REST service should provide clients with a machine-processable specification to describe:
? the requests in terms of available paths, parameters and bodies
? the responses in terms of returned properties and values
? the authentication methods
REST API Specification languages (2)
Some of them are available on the web Each one has its own:
? format ? media type for its delivery as a REST response ? set of tools covering every phase of the API life cycle
(design, build, test, documentation and sharing) ? community of developers
REST API Specification languages (3)
A brief list of the most popular includes:
Name
URL
OpenAPI
swagger.io
RAML
APIBlueprint
JSON API
JSON Schema
json-
Slate
WADL
Neither of them is a standard !!
Language JSON, YAML YAML proprietary JSON JSON MarkDown XML
The set of features they can document is very similar
? A specification can be converted into another by automatic tools
................
................
In order to avoid copyright disputes, this page is only a partial summary.
To fulfill the demand for quickly locating and searching documents.
It is intelligent file search solution for home and business.