Re:Almost everyone is doing the API economy wrong
by bliti on Monday March 21, 2016 @11:39PM
(#11334272)
The vain of my existence. APIs are about data structures, relationships and metadata. Give me these things without requiring me to go through your GUI to figure out what goes where. And yes, do come up with use cases for the API. Try and see it from the point of view of someone who does not know the implementation details. It's a very simple concept that for some reason gets lost.
[ Parent
| on HN ]
Re:Almost everyone is doing the API economy wrong
by antfarm on Tuesday March 22, 2016 @07:25AM
(#11335694)
HAL - Hypertext Application Language
"HAL is a simple format that gives a consistent and easy way to hyperlink between resources in your API. Adopting HAL will make your API explorable, and its documentation easily discoverable from within the API itself. In short, it will make your API easier to work with and therefore more attractive to client developers. APIs that adopt HAL can be easily served and consumed using open source libraries available for most major programming languages. It's also simple enough that you can just deal with it as you would any other JSON."
Re:Almost everyone is doing the API economy wrong
by bliti on Tuesday March 22, 2016 @09:26AM
(#11336360)
Yes, pretty much HAL. I've never seen an API use this in the real world. I integrate with a lot of non-startup APIs and they can barely respond with proper JSON.