Konwertuj format XML na JSON
DOTYCZY: Wszystkie warstwy usługi API Management
Zasady xml-to-json
konwertują treść żądania lub odpowiedzi z xml na JSON. Te zasady mogą służyć do modernizacji interfejsów API opartych na usługach internetowych zaplecza tylko w formacie XML.
Uwaga
Ustaw elementy zasad i elementy podrzędne w kolejności podanej w instrukcji zasad. Dowiedz się więcej na temat ustawiania lub edytowania zasad usługi API Management.
Instrukcja zasad
<xml-to-json kind="javascript-friendly | direct" apply="always | content-type-xml" consider-accept-header="true | false" always-array-child-elements="true | false"/>
Atrybuty
Atrybut | opis | Wymagani | Wartość domyślna |
---|---|---|---|
kind | Atrybut musi być ustawiony na jedną z następujących wartości. - javascript-friendly — przekonwertowany kod JSON ma formularz przyjazny dla deweloperów języka JavaScript.- direct — przekonwertowany kod JSON odzwierciedla strukturę oryginalnego dokumentu XML.Wyrażenia zasad są dozwolone. |
Tak | Nie dotyczy |
apply | Atrybut musi być ustawiony na jedną z następujących wartości. - always - konwertuj zawsze.- content-type-xml — konwertuj tylko wtedy, gdy nagłówek content-type odpowiedzi wskazuje obecność kodu XML.Wyrażenia zasad są dozwolone. |
Tak | Nie dotyczy |
rozważanie-akceptowanie nagłówka | Atrybut musi być ustawiony na jedną z następujących wartości. - true - zastosuj konwersję, jeśli żądanie JSON jest żądane w żądaniu Zaakceptuj nagłówek.- false -zawsze stosuje konwersję.Wyrażenia zasad są dozwolone. |
Nie. | true |
always-array-child-elements | Atrybut musi być ustawiony na jedną z następujących wartości. - true — Zawsze konwertuj elementy podrzędne na tablicę JSON.- false — Konwertuj tylko wiele elementów podrzędnych na tablicę JSON. Przekonwertuj pojedynczy element podrzędny na obiekt JSON.Wyrażenia zasad są dozwolone. |
Nie. | false |
Użycie
- Sekcje zasad: ruch przychodzący, ruch wychodzący, on-error
- Zakresy zasad: globalny, obszar roboczy, produkt, interfejs API, operacja
- Bramy: klasyczne, v2, zużycie, self-hosted, obszar roboczy
Przykład
<policies>
<inbound>
<base />
</inbound>
<outbound>
<base />
<xml-to-json kind="direct" apply="always" consider-accept-header="false" />
</outbound>
</policies>
Powiązane zasady
Powiązana zawartość
Aby uzyskać więcej informacji na temat pracy z zasadami, zobacz:
- Samouczek: przekształcanie i ochrona interfejsu API
- Dokumentacja zasad dla pełnej listy instrukcji zasad i ich ustawień
- Wyrażenia zasad
- Ustawianie lub edytowanie zasad
- Ponowne używanie konfiguracji zasad
- Repozytorium fragmentów zasad
- Zestaw narzędzi zasad usługi Azure API Management
- Tworzenie zasad przy użyciu rozwiązania Microsoft Copilot na platformie Azure