From POX to HATEOAS, Our Company's Journey to Build a Hypermedia API

Luke Stokes (08.Feb.2013 at 16:00)
Talk at SunshinePHP Developer Conference (English - US)

Rating: 5 of 5

We started FoxyCart.com in 2007 and soon after slapped together some XML and called it an API. As our customer base grew and third-party integrations emerged, the need for a true REST API became a priority. Beginning in 2012, we started researching best practices for modern API development. This talk will tell the story of that research and 10-months of development that followed. You’ll get a look at the HAL hypermedia format along with some best practices we came up with for our problem domain of exposing our entire admin interface. We’ll cover a lot. You may need a seat belt.

Who are you?

Claim talk

By clicking this button you are declaring that you are the speaker responsible for it and a claim request will be sent to the administrator of the event.

If the claim is approved you will be able to edit the information for this talk.

Are you sure?

 
Comments closed.

Comments

Rating: 5 of 5

08.Feb.2013 at 19:41 by Larry Garfield (10 comments)

Excellent talk, including new material even for me. I'm going to have to look into a few of the practical tools mentioned, like vnd.error and HAL.

Rating: 5 of 5

08.Feb.2013 at 22:12 by LuisCordova (79 comments)

I had seen this talk on the master series, and it is very good, however not sure why I did not understand things I have already seen. Maybe about this time and being so far from the speaker made me sleepy and I got distracted. Please speak louder so that everyone can be drawn to what you are saying. The nice thing was the t-shirts you gave away. I got one :), and I ask you about the API, however I couldn't ask you more. I believe if you put a guzzle client plugin for OAuth2.0 open source that would be great. Please let me know. Thanks!

Rating: 5 of 5

09.Feb.2013 at 00:05 by Carlos Mario Mejia (2 comments)

Great talk, Thanx!

Rating: 5 of 5

09.Feb.2013 at 09:17 by louis (24 comments)

Great talk, well researched but lacking the depth of real world experience. Still, I learned a lot and enjoyed it.

Rating: 2 of 5

09.Feb.2013 at 09:30 by Matthew Davis (4 comments)

There were some very strange decisions with the API that was being 'demoed'. I expected the talk to be more of a tutorial in building a REST API from scratch, but instead it was like an auto-generated API demo page of the (non) RESTful FoxyCart API. Pretty disappointing.

Rating: 5 of 5

09.Feb.2013 at 09:39 by John Howard (1 comments)

Great talk -- the only reason that we have not fully committed to REST was because of no documentation for the routes. Your example of using HAL and links definitely answered some of those questions for us. I am looking forward to taking those ideas back to my company and having some serious discussions on the possibilities.

Rating: 5 of 5

09.Feb.2013 at 10:48 by Matthew Turland (67 comments)

Excellent introduction that went beyond REST to cover specifics on hypermedia APIs. Luke is a very informed and passionate speaker about the topic. It was refreshing to have a topic go beyond commonly known REST best practices and delve into the technology and standards that can be used to take APIs to the next level.

Rating: 5 of 5

09.Feb.2013 at 11:53 by Matt Frost (72 comments)

Excellent talk, I was glad to see the focus on Hypermedia and differentiation between approaches that are commonly found. I also really enjoyed that Luke ensured all the questions were thoroughly answered, as the topic is more theoretically complex than what I'm used to. Very good presentation style, very easy to listen to and motivated me to learn more. Excellent talk and presentation, great work!

Rating: 5 of 5

09.Feb.2013 at 11:53 by Matt Frost (72 comments)

Excellent talk, I was glad to see the focus on Hypermedia and differentiation between approaches that are commonly found. I also really enjoyed that Luke ensured all the questions were thoroughly answered, as the topic is more theoretically complex than what I'm used to. Very good presentation style, very easy to listen to and motivated me to learn more. Excellent talk and presentation, great work!

Rating: 4 of 5

10.Feb.2013 at 10:23 by David Buchmann (71 comments)

interesting talk, and thanks for being not another REST intro talk but showing how you solved the actual problem. i was a bit lost as to how you expect this api to be used (client parsing and writing raw json versus having a client library that wraps this into objects...). some more concrete examples of why you took this or that design decision would have been interesting to see.

Speaker comment:

11.Feb.2013 at 13:28 by Luke Stokes (30 comments)

Thanks so much for the encouragement, everyone! If you'd like more details on our specific API project, we'll be blogging it. We already have a couple posts up you may find useful:

http://www.foxycart.com/blog/the-hypermedia-debate
http://www.foxycart.com/blog/hypermedia-dog-food

@Matthew D: thanks for meeting with me later in the conference to clarify your comment.
@David B: I've given this one a few times, and I think it started out as a story but then changed to include more details on what hypermedia actually is based on feedback. I should probably have a different title/description to better set expectations. As for a objects in a client library, that's a long, interesting discussion worth having. :)

Thanks again, everyone! I really appreciate your input.

© Joind.in 2014