ID별 수익 내보내기 요청 가져오기
대기 중인 기존 내보내기 요청의 상태를 가져옵니다.
REST 요청
GET https://api.partner.microsoft.com/v1.0/payouts/transactionhistory/{transactionHistoryRequestId}
요청 매개 변수
이름 | 안으로 | 필수 | 유형 | 묘사 |
---|---|---|---|---|
요청 ID (requestId) | 쿼리 | 진실 | 가이드 (GUID) | 요청 ID 내보내기 |
요청 헤더
이름 | 필수 | 유형 | 설명 |
---|---|---|---|
권한 부여 | 예 | 문자열 | 권한 부여 전달자 토큰입니다. |
ms-correlationid | 아니요 | 문자열 | 내부 요청 추적기입니다. 각 요청은 새 추적기(GUID)를 생성합니다. |
ms-requestid (요청 ID) | 아니요 | 문자열 | 요청의 항등성 ID입니다. |
요청 본문
해당하지 않습니다.
응답 페이로드
API는 HTTP 상태 200을 반환합니다.
요청에 따라 API는 표준 API 응답 상태에 나열된 다른 표준 상태를 반환할 수 있습니다.
이름 | 묘사 |
---|---|
400 잘못된 요청 | 누락되거나 잘못된 데이터가 있습니다. |
401 권한 없음 | 호출자는 인증되지 않으며 첫 번째 호출을 하기 전에 파트너 API 서비스를 사용하여 인증해야 합니다. |
403 금지됨 | 호출자에게 요청을 할 권한이 없습니다. |
500 내부 서버 오류 | API 또는 해당 종속성 중 하나가 요청을 처리할 수 없습니다. 나중에 다시 시도하세요. |
404 찾을 수 없음 | 입력 매개 변수와 함께 리소스를 사용할 수 없습니다. |
429 속도 제한 | 동일한 형식의 요청이 너무 많습니다. 잠시 후에 시도해 보세요. |
API 응답 페이로드는 다음 특성을 반환합니다.
이름 | 선택적 | 설명 |
---|---|---|
가치 | 거짓 | 가능한 값과 동작은 다음 표를 참조하세요. |
가능한 값 및 작업
가치 | 클라이언트 작업 |
---|---|
요청 ID | 내보내기 요청의 요청 ID입니다. |
요청일시 | 내보내기 요청의 시작 날짜/시간입니다. |
요청경로 | 내보내기 요청의 쿼리 경로입니다. |
요청 쿼리 문자열 | 내보내기 요청의 일부로 사용되는 필터입니다. |
블랍 위치 | 내보내기 파일이 준비되면 토큰이 있는 Blob 리소스입니다. |
상태 | 내보내기 작업 상태입니다. 상태에 대한 가능한 값의 다음 목록을 참조하세요. |
상태에 대한 가능한 값
- 대기: 내보내기 작업이 시작되지 않았습니다.
- 처리: 내보내기 작업이 진행 중입니다.
- 실패한: 내보내기 작업이 재시도 후에도 실패했습니다. 새 요청을 대기열에 추가해 보세요.
- 완료된: 내보내기 작업이 완료되고 내보내기 파일을 다운로드할 준비가 된 것입니다.