다음을 통해 공유


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>

정책 작업에 대한 자세한 내용은 다음을 참조하세요.