通过

按 ID 获取收益导出请求

  • 项目

获取现有排队导出请求的状态。

REST 请求

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

请求参数

名称 在 必须 类型 说明
requestId 查询 正确 Guid 导出请求 ID

请求头

名称 必须 类型 说明
授权 是 字符串 授权持有者令牌。
ms-correlationid 否 字符串 内部请求跟踪器。 每个请求都会 (GUID) 生成新的跟踪器。
ms-requestid 否 字符串 请求幂等 ID。

请求正文

不适用。

响应有效负载

API 返回 HTTP 状态 200。

API 可以根据请求返回标准 API 响应状态中列出的其他标准状态：

名称 说明
400 错误的请求 缺少或不正确的数据。
401 未授权 调用方未经过身份验证，必须在进行第一次调用之前向合作伙伴 API 服务进行身份验证。
403 禁止访问 调用方无权发出请求。
500 内部服务器错误 API 或其依赖项之一无法满足请求。 请稍后再试。
404 未找到 资源不可用于输入参数。
429 速率限制 同一类型的请求太多。 稍后再试。

API 响应有效负载返回以下属性：

名称 可选 说明
值 false 有关可能的值和操作，请参阅下表。

可能的值和操作

值 客户端操作
requestId 导出请求的请求 ID。
requestDateTime 导出请求的启动日期/时间。
requestPath 导出请求的查询路径。
requestQueryString 用作导出请求一部分的筛选器。
blobLocation 导出文件准备就绪时包含令牌的 Blob 资源。
状态 导出操作状态。 有关状态，请参阅以下可能值列表。

状态的可能值

  • 已排队：导出操作尚未启动
  • 正在处理：导出操作正在进行中
  • 失败：导出操作在重试后失败，请尝试将新请求排队
  • 已完成：导出操作已完成，导出文件已准备好下载。