Skip to content

Instantly share code, notes, and snippets.

@craigbeck

craigbeck/HATEOS-restful-api.md

Last active June 16, 2016 22:43
Show Gist options
  • Star 0 You must be signed in to star a gist
  • Fork 0 You must be signed in to fork a gist
  • Save craigbeck/949f1694ab085a82b22cdee99bbcbe29 to your computer and use it in GitHub Desktop.
Save craigbeck/949f1694ab085a82b22cdee99bbcbe29 to your computer and use it in GitHub Desktop.
Download ZIP
HATEOS/Restful API design resources
Raw
HATEOS-restful-api.md

RESTful/HATEOAS API design resources

Benefits fo embedding URLs

  • Client doesnt have to know
    • how to format URL given an ID, query etc
    • that your API URLs changed, allowing refactoring at development that doesn't impact that client, and allows for more flexible deployments and changes in environment with minimal code to accomodate
  • Easy access to related resources

What about GraphQL?

GraphQL changes this completely. By providing a query syntax that allows querying of related entities (i.e. the graph) a lot of the linking between entities of RESTful resources is not required.

GraphQL

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment