Disqus - Latest Comments for mamund

Re: My Year In Review From A to Z

Mike Amundsen — Wed, 27 Dec 2017 12:42:55 -0000

love this piece. thanks for all the good work!

Re: Hypermedia API vs complex processes - Tomasz Pluskiewicz

Mike Amundsen — Sat, 19 Dec 2015 17:40:54 -0000

Nice blog post. I gave a talk earlier this year that identifies some common patterns that can be used to cover the last two levels in your model. http://amundsen.com/talks/2...

Transcript/Recording is not available yet, but the slides will give you the basic idea.

Would be interested in your comments/feedback on what I posted there.

cheers.

Re: Service Discovery, The Easy Way

Mike Amundsen — Thu, 03 Sep 2015 14:24:26 -0000

<snip>
web browsers that use a link to discover a service for searching.
</snip>
if that's the discovery you have in mind, i don't think i have anything else to add here.

cheers.

Re: Service Discovery, The Easy Way

Mike Amundsen — Thu, 03 Sep 2015 13:52:27 -0000

rel="search" -- is that what this blog post is about?

Re: Service Discovery, The Easy Way

Mike Amundsen — Thu, 03 Sep 2015 13:39:21 -0000

not to put too fine a point on it but what you describe here is service *usage*, not discovery. the website _uses_ services. the human already *discovered* the website back in the past and _uses_ a bookmark (or typing skills) to return to that site.

there is no need for the website to _force_ humans to "discover" the CDN, ad-providers, etc. since the website has that handled. and most of our API implementations are like that, too. we do't do any runtime discovery at all.

so, we don't need to create "discovery service" for what you describe since *there is no discovery going on at all.*

no, if you really wanted to engage in discovery...

Re: Five Years Of API Evangelist

Mike Amundsen — Fri, 03 Jul 2015 19:43:58 -0000

+100 all the way. thanks for all you do.

Re: What is ALPS?

Mike Amundsen — Wed, 11 Mar 2015 18:00:47 -0000

Anthony:

Mark Foster is the key driving force on this spec right now. he has the most hands-on experience implementing it and is doing quite a bit to improve the spec in general. it's great working w/ him on it.

hope to see you on the list, too!

Re: What's a link?

Mike Amundsen — Tue, 10 Mar 2015 20:49:26 -0000

if you start pursuing a hypermedia-style route, be sure to post to the hypermedia-web list. lots of smart folks there who can offer feedback.

cheers.

Re: What's a link?

Mike Amundsen — Tue, 10 Mar 2015 19:19:30 -0000

no problem. love what you're working on here.

i did something a bit dff several years ago by focusing on a higher-level abstraction of links and forms -- H-Factors.
http://amundsen.com/hyperme...

the idea is to identify common actions within media-types and give them a name. most all media types support the LO factor (link-outbound) and few support the LI factor (idempotent write). and so forth.

Re: What's a link?

Mike Amundsen — Tue, 10 Mar 2015 19:09:27 -0000

check out Stephen Mizell's HyperDescribe project: http://smizell.com/weblog/2...

I think you two may be working toward a similar goal.

Re: What is ALPS?

Mike Amundsen — Tue, 10 Mar 2015 15:49:28 -0000

Kin:

Thanks for the shout-out on ALPS. I should point out that ALPS is a joint effort I am working on w/ Mark Foster of Apiary and is based on ideas initially worked out w/ Leonard Richardson (Richardson Maturity Model, RESTful Web Services, RESTful Web APIs, etc.).

As you can tell from the thread you're watching, there is still quite a bit of work to be done to make ALPS useful and I am always willing to talk w/ folks about it anytime, anywhere. Anyone interested in helping us sort this out and make it better can visit http://alps.io and find links to the current IETF Draft, the repo and discussion list.

Thanks for putting us in your radar!

Re: The Machine Readable Questions We Should Ask Of Terms Of Service

Mike Amundsen — Wed, 04 Jun 2014 20:35:18 -0000

would be interesting to see how many of the keywords in tosdr can be matched to keywords in other dictionaries/registries such as http://www.iana.org/assignm..., http:schema.org, microformats.org, and dublincore.org.

Re: I have a voice

Mike Amundsen — Fri, 16 May 2014 19:13:57 -0000

initial spec for OPTIONS was very loose. to prevent future problems, it was marked no-cache and there we are. unable to "undo" a contract promise here in the future, we are living we/ the outcome. it's not the first/only regret on the initial HTTP design, but hey...

that's why relying on OPTIONS as the avenue for describing hypermedia controls is a bad idea. use the message body. if you refuse to include controls in your initial response, you need to get used to the idea of asking for additional GETs in order to find out what's possible. HTML, Collection+JSON, Siren, all accept this reality and return controls in the initial body.

Re: Hello World Product API With Blueprint, RAML And Swagger

Mike Amundsen — Tue, 11 Mar 2014 03:16:09 -0000

np. we can discuss when we're together in Amsterdam for #APIStrat later this month.

Re: Hello World Product API With Blueprint, RAML And Swagger

Mike Amundsen — Sun, 09 Mar 2014 17:17:37 -0000

nice post. FWIW, i threw together a version of the "Product API" using ALPS. maybe we can talk about it sometime: https://gist.github.com/mam...

Re: What Is A Hypermedia API?

Mike Amundsen — Thu, 09 Jan 2014 01:44:24 -0000

always trying to learn...

Re: What Is A Hypermedia API?

Mike Amundsen — Thu, 09 Jan 2014 00:34:02 -0000

"as part of the content type"...

what does Fielding mean when he says:
"A REST API should spend almost all of its descriptive effort in defining the media type(s) used for representing resources and driving application state, or in defining extended relation names and/or hypertext-enabled mark-up for existing standard media types."

BTW - your version of the above was:
"Automated agents are dependent on their understanding of the media types, link types, or microformat extensions provided in representations."

specifically, i am asking you what he means when he lists three things: "media types", "extended relation names", and "hypertext-enabled markup." why three? are they all (as you assert here) "part of the content type"?

Re: What Is A Hypermedia API?

Mike Amundsen — Thu, 09 Jan 2014 00:13:37 -0000

from the top of this thread:
"using HTML is RESTful"
and now you say:
"I don't think it's possible to implement a domain-specific API that is RESTful using HTML."

i got that right?

Re: What Is A Hypermedia API?

Mike Amundsen — Thu, 09 Jan 2014 00:05:06 -0000

OK, try this:
"If someone wanted to create an API for ecommerce would they not need a "place-order" URL? That's why I'm saying I don't think it's possible to implement a domain-specific API that is RESTful using HTML"

Is that a true statement?

Re: What Is A Hypermedia API?

Mike Amundsen — Wed, 08 Jan 2014 23:56:33 -0000

@MikeSchinkel

"use the place order URL"? you're joking right? there is no such thing in Cj. links and forms in Cj work exactly the same as links and forms in HTML.

for example:
HTML: <a href="..." rel="alternate">...</a>
works *exactly* the same as
Cj: {link:{href:"..." rel:"alternate" prompt="..."}}

Re: What Is A Hypermedia API?

Mike Amundsen — Wed, 08 Jan 2014 23:33:09 -0000

@MikeSchinkel:
<snip>
"Cj Browsers" cannot know how to process all potential links.
</snip>

you've not actually tried to implement a Cj app have you?

in fact, all the HTTP protocol details are defined and immutable in Cj. and yes, "Cj Browsers" *always* know how to process potential links - without the need to refer to human readable documentation.

Just like a compliant HTML browser can work with any server that emits valid HTML representations, a compliant Cj browser can work with any server that emits valid Cj.

BTW - this is not true for HAL. it's important not to conflate their design goals or implementation requirements.

Re: What Is A Hypermedia API?

Mike Amundsen — Wed, 08 Jan 2014 22:56:44 -0000

HTML is a generic media type and yet you say HTML is RESTful and Cj is not. What, in the definition of HTML is different from Cj that makes this so?

Re: What Is A Hypermedia API?

Mike Amundsen — Wed, 08 Jan 2014 22:31:42 -0000

@MikeSchinkel:

you mean if Cj didn't have 6.5 it'd be RESTful?

Re: What Is A Hypermedia API?

Mike Amundsen — Wed, 08 Jan 2014 21:37:27 -0000

@MikeSchinkel:

HTML is RESTful and HAL and Cj are not?
- why is cj.template *not* RESTful and HTML.FORM is RESTful?
- why is cj.link@embed="true" *not* RESTful and HTML.IMG is RESTful?

and why is "application/invoice" RESTful?

Re: Will Internet of Things And The SDK Push Out REST?

Mike Amundsen — Tue, 07 Jan 2014 20:42:38 -0000

Always good to 'talk' w/ you. Looking forward to APIStrat Amsterdam, too. Cheers.