The purpose of sp-rest-api.js is to make it easier to query SharePoint REST API by providing a few shortcuts and convenient defaults for common CRUD operations, such as reading, updating and deleting list items.

There's no need to learn - begin right away with examples below.

All you need to get started is:

<script src="sp-rest-api.js"></script>

// Read all items from the Projects list in SharePoint,
// and print them using console.log(), the default callback.
var api = new SpRestApi();
api.lists('Projects').getAllItems();

// Read a single SharePoint list item, and run a callback
// after success or error.
var api = new SpRestApi({
    listTitle: 'Projects',
    onsuccess: function(data) {
        alert('Success!');
    },
    onerror: function(data) {
        alert('Error!');
    },
});
api.getItem(123);

// Updates a single SharePoint list item, setting
// the value in the 'Status' column to 'Completed'.
var api = new SpRestApi({
    listTitle: 'Projects',
    onsuccess: function() { alert('Done!'); }, 
});
api.updateItem(81, { Status: 'Completed' });

// Deletes a single SharePoint list item, runs callback
var api = new SpRestApi({
    listTitle: 'Projects',
    onsuccess: function() { alert('Done!'); },
});
api.deleteItem(491);

• jQuery 1+
• SharePoint 2013, 2016 or online

If using this library in a non-SharePoint page (e.g. in a normal HTML file), you need to specify the siteUrl option when initializing the SpRestApi, and then run refreshDigest() to get the authorization token. Until refreshDigest() completes successfully, all SharePoint API calls will fail.

var api = new SpRestApi({
    siteUrl: 'http://sharepoint.example.com/sites/mysite',
});
api.refreshDigest(initializePage); // Insert your callback function here

Just place sp-rest-api.js into any folder on the site, e.g. into /SiteAssets, and include it after the jQuery and SP JavaScript files:

<script src='../SiteAssets/sp-rest-api.js'></script>

If using inside a SharePoint page, the <script> tag cannot be placed after SharePoint's <input id="__REQUESTDIGEST" type="hidden"> tag, otherwise you will need to run refreshDigest() manually to get the SP authorization token.

This library is now in development. Target completion date: end of August 2017.

See the jsdoc for full description of methods and options.

• new SpRestApi() - create new instance, set options
• config() - set options after the object was created
• lists() - sets the list name only (can also be set via config())

• getAllItems() - fetch all items from a list
• getAllItemsFromListSubfolder() - fetch all items from a subfolder in a list
• getItem() - fetch a single item from the list

• createItem() - creates a single list item.
• updateItem() - updates a single list item.
• deleteItem() - deletes a single list item.

• getUserById() - fetch information about a SharePoint user by their ID.
• getCurrentUser() - same as getUserById(), called with the ID of the current user.

• getContextInfo() - fetch context information, including the authorization token.
• refreshDigest() - gets a new the SharePoint security validation / token, and stores it in the options.

• addMaxItems() - adds $top parameter to URL.
• appendSelectQueryString() - adds the $select= parameter in the URL string.
• loadUrl() - fetches the specified URL.
• generateSingleListItemUrl() - generates the API URL to fetch/delete a single list item
• generateGetAllListItemsUrl() - generates the API URL to fetch all items from a list
• getListItemType() - generates the ListItemType which is required by SharePoint when creating a new list item
• replaceSharepointSpecialChars() - escapes special characters (like underscores and spaces) like _x0020_
• continueRecursiveFetch() - continues fetching all list items if options.recursiveFetch is on.

Public domain. Do whatever you want.

Pull requests, bug reports and feature requests are welcome.