파트너 센터 REST API에서 지원하는 파트너 센터 REST 및 응답 헤더

적용 대상: 파트너 센터 | 21Vianet에서 운영되는 파트너 센터 | Microsoft Cloud for US Government 파트너 센터

파트너 센터 REST API는 다음 HTTP 요청 및 응답 헤더를 지원합니다. 모든 API 호출이 모든 헤더를 수락하는 것은 아닙니다.

REST 요청 헤더

파트너 센터 REST API는 파트너 센터 REST API에서 지원되는 다음 HTTP 요청 헤더를 지원합니다.

헤더 설명 값 유형
권한 부여: 필수입니다. 전달자 <토큰>의 인증 토큰입니다. string
수락: 요청 및 응답 유형, 애플리케이션/json을 지정합니다. string
MS-RequestId: 호출에 대한 고유 식별자이며 id-potency를 보장하는 데 사용됩니다. 시간 제한이 있는 경우 재시도 호출에 동일한 값이 포함되어야 합니다. 응답(성공 또는 비즈니스 오류)을 수신하면 다음 호출에 대한 값을 다시 설정해야 합니다. GUID
MS-CorrelationId: 호출의 고유 식별자이며, 오류 문제 해결을 위한 로그 및 네트워크 추적에 유용합니다. 모든 호출마다 값을 재설정해야 합니다. 모든 작업에 이 헤더를 포함해야 합니다. 자세한 내용은 테스트 및 디버그의 상관 관계 ID 정보를 참조하세요. GUID
MS-Contract-Version: 필수입니다. 요청된 API의 버전을 지정합니다. 이 값은 일반적으로 api-version: v1 시나리오 섹션에 달리 지정 하지 않는 한. string
If-Match: 동시성 제어에 사용됩니다. 일부 API 호출은 If-Match 헤더를 통해 ETag를 전달해야 합니다. ETag는 일반적으로 리소스에 있기 때문에 최신 GET-ting이 필요합니다. 자세한 내용은 테스트 및 디버그의 ETag 정보를 참조하세요. string
MS-PartnerCenter-Application 선택 사항. 파트너 센터 REST API를 사용하는 애플리케이션의 이름을 지정합니다. string
X-로캘: 선택 사항. 요금이 반환되는 언어를 지정합니다. 기본값은 en-US입니다. 지원되는 값 목록은 파트너 센터에서 지원되는 언어 및 로캘을 참조 하세요. string

REST 응답 헤더

파트너 센터 REST API는 다음 HTTP 응답 헤더를 반환할 수 있습니다.

헤더 설명 값 유형
수락: 요청 및 응답 유형, 애플리케이션/json을 지정합니다. string
MS-RequestId: 호출에 대한 고유 식별자이며 id-potency를 보장하는 데 사용됩니다. 시간 제한이 있는 경우 재시도 호출에 동일한 값이 포함되어야 합니다. 응답(성공 또는 비즈니스 오류)을 수신하면 다음 호출에 대한 값을 다시 설정해야 합니다. GUID
MS-CorrelationId: 호출에 대한 고유 식별자입니다. 이 값은 오류를 찾기 위해 로그 및 네트워크 추적 문제를 해결하는 데 유용합니다. 모든 호출마다 값을 재설정해야 합니다. 모든 작업에 이 헤더를 포함해야 합니다. GUID