Condividi tramite

Ottenere la richiesta di esportazione degli utili in base all'ID

  • Articolo

Ottiene lo stato di una richiesta di esportazione in coda esistente.

Richiesta REST

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

Parametri della richiesta

Nome In Obbligatoria Tipo Descrizione
requestId Query True Guid Esporta ID richiesta

Intestazione della richiesta

Nome Obbligatorio Tipo Descrizione
Autorizzazione Sì string Token di connessione dell'autorizzazione.
ms-correlationid No string Strumento di rilevamento delle richieste interne. Ogni richiesta genera un nuovo tracker (GUID).
ms-requestid No string ID di idempotenza della richiesta.

Testo della richiesta

N/D.

Payload della risposta

L'API restituisce lo stato HTTP 200.

In base alla richiesta, l'API può restituire altri stati standard elencati in stato di risposta API Standard:

Nome Descrizione
400 - Richiesta non valida Non sono presenti dati mancanti o non corretti.
401 - Non autorizzato Il chiamante non è autenticato e deve eseguire l'autenticazione con il servizio API partner prima di effettuare la prima chiamata.
403 - Accesso negato Il chiamante non è autorizzato a effettuare la richiesta.
500 - Errore interno del server L'API o una delle relative dipendenze non è in grado di soddisfare la richiesta. Riprovare più tardi.
404 - Non trovato Risorsa non disponibile con i parametri di input.
429 Limitazione della frequenza Troppe richieste dello stesso tipo. Prova dopo un po' di tempo.

Il payload della risposta API restituisce gli attributi seguenti:

Nome Facoltativo Descrizione
Valore false Per i valori e le azioni possibili, vedere la tabella seguente.

Possibili valori e azioni

Valore Azione client
requestId ID richiesta della richiesta di esportazione.
requestDateTime Data di avvio della richiesta di esportazione.
requestPath Percorso query della richiesta di esportazione.
requestQueryString Filtro usato come parte della richiesta di esportazione.
BLOBLocation Risorsa BLOB con token quando il file di esportazione è pronto.
Stato Esportare lo stato dell'operazione. Vedere l'elenco seguente dei valori possibili per lo stato.

Valori possibili per lo stato

  • Accodato: l'operazione di esportazione non è stata avviata
  • Elaborazione: l'operazione di esportazione è in corso
  • Errore: l'operazione di esportazione non è riuscita dopo i tentativi, provare a accodare una nuova richiesta
  • Completato: l'operazione di esportazione è stata completata e il file di esportazione è pronto per il download.