Re:Studio Ghibli API
by liveoneggs on Thursday March 30, 2017 @03:15PM
(#13998079)
a principal of REST which is often ignored or improperly implemented is hypermedia-driven discovery. You should be able to discover the entire api via a top-level entry point which will return a bunch of links.
It's really weird:
- SOAP had discovery
- XML based REST APIs had discovery (via HATEOAS)
- JSON based REST APIs inevitably never have discovery (looks like there's no standard JSON version of the 'link rel' from HATEOAS)
- GraphQL has discovery
Re:Studio Ghibli API
by liveoneggs on Friday March 31, 2017 @08:59AM
(#14003215)
if you implement swagger (now openapi) then you put the discovery in: https://github.com/OAI/OpenAPI-Specification/blob/master/ver...
It's not the first time I see this claim in a REST API. What is it supposed to mean? Does it hint at some form of automatic (machine-driven) discovery, or is it just a pompous way to say they expose capabilities via a REST API?