分享方式：

依識別碼取得收益匯出要求

  • 文章

取得現有佇列匯出要求的狀態。

REST 要求

GET https://api.partner.microsoft.com/v1.0/payouts/transactionhistory/{transactionHistoryRequestId}

要求參數

名稱 位於 必要 類型 描述
requestId 查詢 True Guid 匯出要求識別碼

要求標頭

名稱 必要 類型 描述
授權 是 String 授權持有人權杖。
ms-correlationid 否 String 內部要求追蹤器。 每個要求都會產生新的追蹤器 (GUID) 。
ms-requestid 否 String 要求等冪識別碼。

要求本文

N/A。

回應承載

API 會傳回 HTTP 狀態 200。

根據要求，API 可以傳回標準 API 回應狀態中列出的其他標準狀態：

名稱 描述
400 不正確的要求 資料遺失或不正確。
401 未經授權 呼叫端不會經過驗證，而且必須先向合作夥伴 API 服務進行驗證，才能進行第一次呼叫。
403 禁止 呼叫端未獲授權提出要求。
500 內部伺服器錯誤 API 或其其中一個相依性無法滿足要求。 請稍後再試一次。
404 找不到 輸入參數無法使用資源。
429 速率限制 相同類型的要求太多。 請稍後再試一次。

API 回應承載會傳回下列屬性：

名稱 選用 描述
值 false 如需可能的值和動作，請參閱下表。

可能的值和動作

值 用戶端動作
requestId 匯出要求的要求識別碼。
requestDateTime 匯出要求的起始日期時間。
requestPath 匯出要求的查詢路徑。
requestQueryString 做為匯出要求的一部分使用的篩選。
blobLocation 當匯出檔案就緒時，具有權杖的 Blob 資源。
狀態 匯出作業狀態。 如需狀態，請參閱下列可能值清單。

狀態的可能值

  • 已排入佇列：匯出作業尚未啟動
  • 處理：匯出作業正在進行中
  • 失敗：重試之後匯出作業失敗，請嘗試將新要求排入佇列
  • 已完成：匯出作業已完成，且匯出檔案已可供下載。