Ottenere la richiesta di esportazione degli utili in base all'ID
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.