RESTfest 2013 5 in 5: Hypermedia API Documentation. We're doing it wrong.

1,099 views
995 views

Published on

In this five minute presentation, I argue the tools we use (Swagger, I/O Docs, APIary) are teaching developers to code to URLs which will limit HAPI adoption.

Video available here: http://vimeo.com/75256658

Published in: Technology
0 Comments
0 Likes
Statistics
Notes
  • Be the first to comment

  • Be the first to like this

No Downloads
Views
Total views
1,099
On SlideShare
0
From Embeds
0
Number of Embeds
1
Actions
Shares
0
Downloads
2
Comments
0
Likes
0
Embeds 0
No embeds

No notes for slide

RESTfest 2013 5 in 5: Hypermedia API Documentation. We're doing it wrong.

  1. 1. Documenting Hypermedia APIs Luke Stokes @lukestokes FoxyCart.com
  2. 2. HAPI adoption “It’s not REST if it’s not HATEOS.” “Show me the hypermedia.” … But we teach developers to code to URLs (Swagger, I/O Docs, APIary, etc)
  3. 3. Tells developers to code to URLs
  4. 4. Tools can promote link relationships! (HAL Browser)
  5. 5. Documentation to help us think in relationships...
  6. 6. Coding to link relations https://api.foxycart.com more coders thinking in hypermedia = more HAPI coders more HAPI coders building for hypermedia = more hypermedia tools and clients
  7. 7. api.foxycart.com

×