XML을 JSON으로 변환
적용 대상: 모든 API Management 계층
xml-to-json
정책은 요청 또는 응답 본문을 XML에서 JSON으로 변환합니다. 이 정책은 XML 전용 백 엔드 웹 서비스를 기반으로 하는 API를 최신 형식으로 변환하는 데 사용할 수 있습니다.
참고 항목
정책 문에 제공된 순서대로 정책의 요소 및 자식 요소를 설정합니다. API Management 정책을 설정하거나 편집하는 방법에 대해 자세히 알아봅니다.
정책 문
<xml-to-json kind="javascript-friendly | direct" apply="always | content-type-xml" consider-accept-header="true | false" always-array-child-elements="true | false"/>
특성
특성 | 설명 | 필수 항목 | 기본값 |
---|---|---|---|
kind | 속성은 다음 값 중 하나로 설정해야 합니다. - javascript-friendly - 변환된 JSON에는 JavaScript 개발자에게 익숙한 양식이 있습니다.- direct - 변환된 JSON은 원래 XML 문서의 구조를 반영합니다.정책 식이 허용됩니다. |
예 | 해당 없음 |
apply | 속성은 다음 값 중 하나로 설정해야 합니다. - always - 항상 변환합니다.- content-type-xml - 응답 Content-Type 헤더에서 XML의 존재를 나타내는 경우에만 변환합니다.정책 식이 허용됩니다. |
예 | 해당 없음 |
consider-accept-header | 속성은 다음 값 중 하나로 설정해야 합니다. - true - 요청 Accept 헤더에서 JSON을 요청하는 경우 변환을 적용합니다.- false -항상 변환을 적용합니다.정책 식이 허용됩니다. |
아니요 | true |
always-array-child-elements | 속성은 다음 값 중 하나로 설정해야 합니다. - true - 항상 자식 요소를 JSON 배열로 변환합니다.- false - 여러 자식 요소만 JSON 배열로 변환합니다. 단일 자식 요소를 JSON 개체로 변환합니다.정책 식이 허용됩니다. |
아니요 | false |
사용
예시
<policies>
<inbound>
<base />
</inbound>
<outbound>
<base />
<xml-to-json kind="direct" apply="always" consider-accept-header="false" />
</outbound>
</policies>
관련 정책
관련 콘텐츠
정책 작업에 대한 자세한 내용은 다음을 참조하세요.
- 자습서: API 변환 및 보호
- 정책 문 및 해당 설정에 대한 전체 목록에 대한 정책 참조
- 정책 식
- 정책 설정 또는 편집
- 정책 구성 재사용
- 정책 코드 조각 리포지토리
- Azure API Management 정책 도구 키트
- Azure의 Microsoft Copilot을 사용하는 작성자 정책