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 文档 。