Understand How and Why REST APIs Work

gistfile1.json

{
  "Name": "Tutorial Story",
  "Description": "Great description",
  "Estimate": "5"
}

gistfile2.json

{
  "Name": "Tutorial Story",
  "Description": "This is a much, much better description for something more difficult than a 5",
  "Estimate": "7"
}

gistfile3.js

var client = new VersionOneClient();
client.story.getById(1154).done(function(story) { } );

gistfile4.js

var client = new VersionOneClient();
var storyData = { Name: 'My New Story', Description: 'As a developer, I do not want to learn proprietary API clients', Estimate: 1000 };
client.story.createNew(storyData);

gistfile5.js

var client = new VersionOneClient();
client.workInProgressLimit.getAll().done(function(story) { } );

gistfile6.json

{
  "AssetType": "Story",
  "Description": "Great description",
  "Name": "Tutorial Story",
  "_links": {
    "self": {
      "href": "/platformtest/rest-1.v1/Data/Story/1154",
      "id": "Story:1154"
    },
    "Scope": [
      {
        "href": "/platformtest/rest-1.v1/Data/Scope/0",
        "idref": "Scope:0"
      }
    ]
  }
}