Exportaanvraag voor inkomsten ophalen via ID
Haalt de status van een bestaande exportaanvraag in de wachtrij op.
REST-aanvraag
GET https://api.partner.microsoft.com/v1.0/payouts/transactionhistory/{transactionHistoryRequestId}
Aanvraagparameters
| Naam | In | Vereist | Type | Beschrijving |
|---|---|---|---|---|
| aanvraag-ID | Vraag | Waar | Guid | Exportaanvraag-id |
Aanvraagheader
| Naam | Vereist | Type | Beschrijving |
|---|---|---|---|
| Machtiging | Ja | Snaar | Autorisatie Bearer-token. |
| ms-correlationid | Nee | Snaar | Een interne aanvraagtracker. Elke aanvraag genereert een nieuwe tracker (GUID). |
| ms-requestid | Nee | Snaar | De idempotentie-id van de aanvraag. |
Verzoeklichaam
N.V.T.
Nettolading van antwoord
API retourneert HTTP-status 200.
Op basis van aanvraag kan API andere standaardstatussen retourneren die worden vermeld in de status van de Standaard-API-antwoord:
| Naam | Beschrijving |
|---|---|
| 400 Foutieve aanvraag | Er ontbreken of onjuiste gegevens. |
| 401 Niet geautoriseerd | De aanroeper wordt niet geverifieerd en moet worden geverifieerd met de partner-API-service voordat de eerste aanroep wordt uitgevoerd. |
| 403 Verboden | De beller is niet gemachtigd om de aanvraag te doen. |
| 500 Interne serverfout | De API of een van de bijbehorende afhankelijkheden kan niet voldoen aan de aanvraag. Probeer het later opnieuw. |
| 404 niet gevonden | Resource is niet beschikbaar met invoerparameters. |
| 429 Snelheidsbeperking | Te veel aanvragen van hetzelfde type. Probeer het na een tijdje. |
De nettolading van het API-antwoord retourneert de volgende kenmerken:
| Naam | Facultatief | Beschrijving |
|---|---|---|
| Waarde | onwaar | Zie de volgende tabel voor mogelijke waarden en acties. |
Mogelijke waarden en acties
| Waarde | Clientactie |
|---|---|
| aanvraagId | Aanvraag-id van de exportaanvraag. |
| verzoekDatumTijd | Begindatum van de exportaanvraag. |
| aanvraagpad | Opvraagpad van de exportaanvraag. |
| requestQueryString | Filter dat wordt gebruikt als onderdeel van de exportaanvraag. |
| blobLocation | Blob-resource met token wanneer het exportbestand gereed is. |
| Status | Status van exportbewerking. Zie de volgende lijst met mogelijke waarden voor de status. |
Mogelijke waarden voor status
- In de wachtrij geplaatste: de exportoperatie is nog niet gestart
- verwerking: de exportbewerking wordt uitgevoerd
- mislukt: de exportbewerking is mislukt na nieuwe pogingen en probeer een nieuwe aanvraag in de wachtrij te plaatsen
- voltooide: de exportbewerking is voltooid en het exportbestand kan worden gedownload.