按 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 资源。 |
| 状态 | 导出操作状态。 有关状态，请参阅以下可能值列表。 |
状态的可能值
- 已排队：导出操作尚未启动
- 正在处理：导出操作正在进行中
- 失败：导出操作在重试后失败，请尝试将新请求排队
- 已完成：导出操作已完成，导出文件已准备好下载。