什麼是 Reporting Services 的 REST API？

適用於： SQL Server Reporting Services (2017 與更新版本) ❌ Power BI 報表伺服器

Microsoft SQL Server 2017 Reporting Services 支援具象狀態傳輸 (REST) API。 REST API 是支援一組 HTTP 作業 (方法) 的服務端點，提供報表伺服器中資源的建立、擷取、更新或刪除權限。

REST API 可透過程式設計方式存取 SQL Server 2017 Reporting Services 報表伺服器目錄中的物件。以下為物件範例：

使用 REST API 時，可以巡覽資料夾階層、探索資料夾內容，或下載報表定義。您也可以建立、更新及刪除物件。

注意

如果您想要檢視或刪除個人資料，請檢閱 GDPR 的 Windows 資料主體要求網站中的 Microsoft 指引。如果您想要尋找 GDPR 的一般資訊，請參閱服務信任入口網站的 GDPR 一節。

REST API 要求/回應的元件

REST API 要求/回應配對可分成五個元件：

要求 URI：

要求 URI	描述
URI 配置	表示用來傳輸要求的通訊協定。例如，`http` 或 `https`。
URI 主機	指定裝載 REST 服務端點之伺服器的網域名稱或 IP 位址，例如 `myserver.contoso.com`。
Resource path	指定資源或資源集合，其中可能包含服務用來判斷這些資源選取的多個區段。例如：可使用 `CatalogItems(01234567-89ab-cdef-0123-456789abcdef)/Properties` 取得 `CatalogItem` 的指定屬性。
查詢字串 (選用)	提供其他簡單參數，例如 API 版本或資源選取準則。

HTTP 要求訊息標頭欄位：
- 必要的 HTTP 方法，也稱為作業或動詞命令，
- 這會告知服務所要求的作業類型。 Reporting Services REST API 支援 DELETE、GET、HEAD、PUT、POST 和 PATCH 方法。
- 指定的 URI 和 HTTP 方法所需的額外選擇性標頭欄位。
HTTP 要求訊息內文欄位 (選用)：
- 支援 URI 和 HTTP 作業。例如，POST 作業包含當作複雜參數傳遞的多用途網際網路郵件延伸標準 (MIME) 編碼物件。
- 針對 POST 或 PUT 作業，也必須在 Content-type 要求標頭中指定主體的 MIME 編碼類型。某些服務要求您使用特定 MIME 類型，例如 application/json。
HTTP 回應訊息標頭欄位：
- HTTP 狀態碼，範圍可介於 2xx 成功碼到 4xx 或 5xx 錯誤碼之間。或者，可能會傳回服務定義的狀態碼，如 API 文件中所示。
- 支援要求回應所需的額外選擇性標頭欄位，例如 Content-type 回應標頭。
選擇性的 HTTP 回應訊息主體欄位：
- MIME 編碼回應物件會在 HTTP 回應主體中傳回，例如來自傳回資料之 GET 方法的回應。一般而言，這些物件會以 JSON 或 XML 等結構化格式傳回，如 Content-type 回應標頭所示。

新式 REST API 需要新式 API 文件。 REST API 會以 OpenAPI 規格 (也稱為 Swagger 規格) 來建置。可在 Microsoft Learn 取得文件使用 Power BI 報表伺服器 REST API (英文)。

如需用於測試 HTTP 要求/回應訊息的工具，Fiddler 是可攔截 REST 要求的免費 Web 偵錯 Proxy，能讓您輕鬆診斷 HTTP 要求/回應訊息。