Herschrijvings-URL

  • Artikel

VAN TOEPASSING OP: Alle API Management-lagen

Het rewrite-uri beleid converteert een aanvraag-URL van het openbare formulier naar het formulier dat door de webservice wordt verwacht, zoals wordt weergegeven in het volgende voorbeeld.

  • Openbare URL - http://api.example.com/storenumber/ordernumber

  • Aanvraag-URL - http://api.example.com/v2/US/hardware/storenumber&ordernumber?City&State

Dit beleid kan worden gebruikt wanneer een menselijke en/of browservriendelijke URL moet worden omgezet in de URL-indeling die wordt verwacht door de webservice. Dit beleid hoeft alleen te worden toegepast bij het weergeven van een alternatieve URL-indeling, zoals schone URL's, RESTful-URL's, gebruiksvriendelijke URL's of SEO-vriendelijke URL's die uitsluitend structurele URL's zijn die geen querytekenreeks bevatten en in plaats daarvan alleen het pad van de resource bevatten (na het schema en de instantie). Dit wordt vaak gedaan voor esthetische, bruikbaarheid of SEO-doeleinden (Search Engine Optimization).

Notitie

Stel de elementen en onderliggende elementen van het beleid in de volgorde in die in de beleidsverklaring is opgegeven. Meer informatie over het instellen of bewerken van API Management-beleid.

Beleidsinstructie

<rewrite-uri template="uri template" copy-unmatched-params="true | false" />

Kenmerken

Meetcriterium Beschrijving Vereist Standaardinstelling
sjabloon De werkelijke url van de webservice met queryreeksparameters. Beleidsexpressies zijn toegestaan. Wanneer expressies worden gebruikt, moet de hele waarde een expressie zijn. Ja N.v.t.
copy-unmatched-params Hiermee geeft u op of queryparameters in de binnenkomende aanvraag niet aanwezig zijn in de oorspronkelijke URL-sjabloon worden toegevoegd aan de URL die is gedefinieerd door de herschrijfsjabloon. Beleidsexpressies zijn toegestaan. Nee true

Gebruik

Gebruiksnotities

U kunt alleen queryreeksparameters toevoegen met behulp van het beleid. U kunt geen extra sjabloonpadparameters toevoegen in de herschrijf-URL.

Opmerking

<policies>
    <inbound>
        <base />
        <rewrite-uri template="/v2/US/hardware/{storenumber}&{ordernumber}?City=city&State=state" />
    </inbound>
    <outbound>
        <base />
    </outbound>
</policies>

<!-- Assuming incoming request is /get?a=b&c=d and operation template is set to /get?a={b} -->
<policies>
    <inbound>
        <base />
        <rewrite-uri template="/put" />
    </inbound>
    <outbound>
        <base />
    </outbound>
</policies>
<!-- Resulting URL will be /put?c=d -->

<!-- Assuming incoming request is /get?a=b&c=d and operation template is set to /get?a={b} -->
<policies>
    <inbound>
        <base />
        <rewrite-uri template="/put" copy-unmatched-params="false" />
    </inbound>
    <outbound>
        <base />
    </outbound>
</policies>
<!-- Resulting URL will be /put -->

Gerelateerde inhoud

Zie voor meer informatie over het werken met beleid: