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 文件