Zelfstudie: Gesimuleerde antwoorden van een API
Back-end-API's worden geïmporteerd in een APIM-API (API Management) of handmatig gemaakt en beheerd. In de stappen in deze zelfstudie leert u het volgende:
- Gebruik API Management om een lege HTTP-API te maken
- Een HTTP-API handmatig beheren
- Een beleid instellen voor een API zodat deze een gesimuleerd antwoord retourneert
Met deze methode kunnen ontwikkelaars doorgaan met de implementatie en het testen van de API Management-instantie, zelfs als de back-end niet beschikbaar is om echte antwoorden te verzenden.
De mogelijkheid om antwoorden na te maken is handig in veel scenario's:
- Als de API-kant het eerst wordt ontworpen en de back-end implementatie later volgt. Of als de back-end parallel wordt ontwikkeld.
- Wanneer de back-end tijdelijk niet operationeel is of niet kan worden geschaald.
In deze zelfstudie leert u het volgende:
- Een test-API maken
- Een bewerking aan de test-API toevoegen
- Antwoordsimulatie inschakelen
- De gesimuleerde API testen
Vereisten
- Informatie over de terminologie van Azure API Management.
- Inzicht in het beleidsconcept in Azure API Management.
- Voltooi de volgende quickstart: Een Azure API Management-exemplaar maken.
Een test-API maken
De stappen in deze sectie laten zien hoe u een HTTP-API maakt zonder back-end.
Meld u aan bij de Azure Portal en navigeer vervolgens naar uw API Management exemplaar.
Selecteer API's>+HTTP-tegelAPI> toevoegen.
Selecteer in het venster Een HTTP-API maken de optie Volledig.
Voer Test API in als Display name (Weergavenaam).
Voer Unlimited (Onbeperkt) in bij Products (Producten).
Zorg ervoor dat Beheerd is geselecteerd bij Gateways.
Selecteer Maken.
Een bewerking aan de test-API toevoegen
Een API stelt een of meer bewerkingen beschikbaar. In deze sectie voegt u een bewerking toe aan de HTTP-API die u hebt gemaakt. Als u de bewerking aanroept nadat u de stappen in deze sectie hebt voltooid, wordt er een fout geactiveerd. Nadat u de stappen in de sectie Antwoordsimuleerding inschakelen hebt voltooid, krijgt u geen fouten.
Selecteer de API die u in de vorige stap hebt gemaakt.
Klik op + Bewerking toevoegen.
Voer in het Frontend-venster de volgende waarden in.
Instelling Waarde Beschrijving Weergavenaam Test call (Testaanroep) De naam die wordt weergegeven in de ontwikkelaarsportal. URL (HTTP-woord) GET Selecteer een van de vooraf gedefinieerde HTTP-woorden. URL /test Een URL-pad voor de API. Deschription (Beschrijving) Optionele beschrijving van de bewerking, die wordt gebruikt om de ontwikkelaars die gebruikmaken van deze API in de ontwikkelaarsportal van documentatie te voorzien. Selecteer het tabblad Responses (Antwoorden), dat zich bevindt onder de velden URL, Display name (Weergavenaam) en Description (Beschrijving). Voer instellingen op dit tabblad in om antwoordstatuscodes, inhoudstypen, voorbeelden en schema's te definiëren.
Selecteer + Add response (Antwoord toevoegen) en selecteer 200 OK in de lijst.
Selecteer + Add representation ( Weergave toevoegen) onder de kop Representations (Representaties) aan de rechterkant.
Voer application/json in het zoekvak in en selecteer het inhoudstype application/json.
Voer in
{ "sampleField" : "test" }
het tekstvak Voorbeeld in.Selecteer Opslaan.
Hoewel dit niet vereist is voor dit voorbeeld, kunt u meer instellingen voor een API-bewerking configureren op andere tabbladen, waaronder:
Tabblad | Beschrijving |
---|---|
Query | Voeg queryparameters toe. U kunt niet alleen een naam en beschrijving opgeven, maar ook waarden opgeven die zijn toegewezen aan een queryparameter. U kunt een van de waarden markeren als standaardwaarde (optioneel). |
Aanvraag | Definieer aanvraaginhoudstypen, voorbeelden en schema's. |
Antwoordsimulatie inschakelen
Selecteer de API die u in de stap Een test-API maken hebt gemaakt.
Zorg ervoor dat in het venster aan de rechterkant het tabblad Design (Ontwerp) is geselecteerd.
Selecteer de testbewerking die u hebt toegevoegd.
Selecteer het venster Inbound processing (Binnenkomende verwerking) + Add policy (Beleid toevoegen).
Selecteer Gesimuleerde antwoorden in de galerie.
Typ 200 OK, application/json in het tekstvak API Management response. Deze selectie geeft aan dat uw API het voorbeeldantwoord moet retourneren dat u hebt gedefinieerd in de vorige sectie.
Selecteer Opslaan.
Tip
Er wordt een gele balk met de tekst Mocking ingeschakeld . Dit geeft aan dat de antwoorden die worden geretourneerd van API Management worden gesimuleerd door het mocking-beleid en niet worden geproduceerd door de back-end.
De gesimuleerde API testen
Selecteer de API die u in de stap Een test-API maken hebt gemaakt.
Selecteer het tabblad Testen.
Zorg ervoor dat de API voor aanroepen testen is geselecteerd en selecteer vervolgens Verzenden om een testoproep te maken.
Het HTTP-antwoord geeft de JSON weer die is opgegeven als een voorbeeld in de eerste sectie van de zelfstudie.
Volgende stappen
In deze zelfstudie heeft u het volgende geleerd:
- Een test-API maken
- Een bewerking aan de test-API toevoegen
- Antwoordsimulatie inschakelen
- De gesimuleerde API testen
Ga door naar de volgende zelfstudie: