Obter requisição de exportação de ganhos por ID
Obtém o status de uma solicitação de exportação em fila existente.
Pedido REST
GET https://api.partner.microsoft.com/v1.0/payouts/transactionhistory/{transactionHistoryRequestId}
Parâmetros de solicitação
| Nome | Em | Necessário | Tipo | Descrição |
|---|---|---|---|---|
| ID de pedido | Consulta | Verdadeiro | Guid | ID do pedido de exportação |
Cabeçalho da solicitação
| Nome | Necessário | Tipo | Descrição |
|---|---|---|---|
| Autorização | Sim | String | Token ao portador da autorização. |
| MS-CorrelationID | Não | cadeia de caracteres | Um rastreador de solicitações internas. Cada solicitação gera um novo rastreador (GUID). |
| MS-RequestID | Não | String | O ID de idempotência da solicitação. |
Corpo do pedido
N/A.
Carga útil de resposta
A API retorna o status HTTP 200.
Com base na solicitação, a API pode retornar outros status padrão listados em Status de resposta da API padrão:
| Nome | Descrição |
|---|---|
| 400 Pedido Inválido | Havia dados ausentes ou incorretos. |
| 401 Não autorizado | O chamador não é autenticado e deve autenticar-se com o serviço de API do parceiro antes de fazer a primeira chamada. |
| 403 Proibido | O chamador não está autorizado a fazer a solicitação. |
| 500 Erro interno do servidor | A API ou uma de suas dependências não consegue atender à solicitação. Tente novamente mais tarde. |
| 404 Não encontrado | Recurso não disponível com parâmetros de entrada. |
| 429 Limitação da taxa | Demasiadas requisições do mesmo tipo. Tente depois de algum tempo. |
A carga útil de resposta da API retorna os seguintes atributos:
| Nome | Opcional | Descrição |
|---|---|---|
| Valor | falso | Consulte a tabela a seguir para obter os valores e ações possíveis. |
Valores e ações possíveis
| Valor | Ação do cliente |
|---|---|
| ID de pedido | ID da solicitação de exportação. |
| requestDateTime | Data/hora de início do pedido de exportação. |
| requestPath | Percurso de consulta do pedido de exportação. |
| requestQueryString | Filtro usado como parte da solicitação de exportação. |
| localização do blob | Recurso de Blob com token quando o arquivo de exportação estiver pronto. |
| Situação | Status da operação de exportação. Consulte a seguinte lista de valores possíveis para status. |
Valores possíveis para status
- Em fila: A operação de exportação não foi iniciada
- Processamento: A operação de exportação está em curso
- Falha: A operação de exportação falhou após várias tentativas, tente colocar uma nova solicitação em fila
- Concluído: A operação de exportação foi concluída e o arquivo de exportação está pronto para download.