REST 服务

REST 服务端点 URL

REST 客户端访问 API 最初是在 SharePoint 2010 中引入的,但在 SharePoint 2013 中得到了极大的扩展 .SharePoint 2010 中的 REST API 可通过/_vti_bin/ListData.svc 网址上的 ListData Web 服务进行访问。 SharePoint 2013引入了/_api/lists//_api/web 端点 URL,其行为略有不同。

上面的端点 URL 应该以 http://server/site 开头,其中 server 表示服务器的名称,site 表示特定站点的名称或路径。

……的示例网址 SharePoint 2010 SharePoint 2013
获取列表: /_vti_bin/ListData.svc/ListName /_api/lists('ListGuid')
获取物品: /_vti_bin/ListData.svc/ListName(1) /_api/lists('ListGuid')/items(1)
获取网络: (没有相应的) /_api/web

尽管访问列表和列表项有所不同,但在这两个版本中使用这些结果非常相似。

请注意,为了向后兼容,仍然可以在 SharePoint 2013 中使用 ListData.svc 服务。

发送 REST 请求

可以通过本机 JavaScript XMLHttpRequest 或 jQuery AJAX 包装器构造提交 REST 请求。

XMLHttpRequest 语法

var xhr = new XMLHttpRequest();
xhr.open(verb, url, true);
xhr.setRequestHeader("Content-Type","application/json");
xhr.send(data);

jQuery AJAX 语法

$.ajax({
    method: verb,
    url: url,
    headers: { "Content-Type":"application/json" },
    data: data
});

有关通过 AJAX 发送请求的更多详细信息,请参阅 JavaScript AJAX 文档