다음을 통해 공유


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 리소스입니다.
상태 내보내기 작업 상태입니다. 상태에 대한 가능한 값의 다음 목록을 참조하세요.

상태에 대한 가능한 값

  • 대기: 내보내기 작업이 시작되지 않았습니다.
  • 처리: 내보내기 작업이 진행 중입니다.
  • 실패한: 내보내기 작업이 재시도 후에도 실패했습니다. 새 요청을 대기열에 추가해 보세요.
  • 완료된: 내보내기 작업이 완료되고 내보내기 파일을 다운로드할 준비가 된 것입니다.