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