REST 服務

Created: November-22, 2018

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