Notitie
Voor toegang tot deze pagina is autorisatie vereist. U kunt proberen u aan te melden of de directory te wijzigen.
Voor toegang tot deze pagina is autorisatie vereist. U kunt proberen de mappen te wijzigen.
API-ontwikkelaars in uw organisatie kunnen API's in uw API-centrum detecteren en gebruiken met behulp van de Azure API Center-extensie voor Visual Studio Code. De extensie biedt de volgende functies:
ONTDEK API's : blader door de API's in uw API-centrum en bekijk de bijbehorende details en documentatie.
API's gebruiken: API SDK-clients genereren in hun favoriete taal, waaronder JavaScript, TypeScript, .NET, Python en Java, met behulp van de Microsoft Kiota-engine waarmee SDK's voor Microsoft Graph, GitHub en meer worden gegenereerd.
API-ontwikkelaars kunnen ook profiteren van functies in de extensie om API's te registreren in het API-centrum en ervoor te zorgen dat API-governance wordt gegarandeerd.
Aanbeveling
Als u wilt dat ontwikkelaars van bedrijfs-apps uw API's op een centrale locatie detecteren, schakelt u desgewenst de alleen-lezen-API Center-portalweergave in Visual Studio Code in.
Vereisten
Een of meer API-centra in uw Azure-abonnement. U kunt een API-centrum maken met behulp van de Azure API Center-extensie of andere hulpprogramma's.
- Op dit moment moet u de rol Azure API Center-servicebijdrager of hogere machtigingen voor een API-centrum toewijzen om API's te beheren met de extensie.
- REST-clientextensie : http-aanvragen verzenden en de antwoorden rechtstreeks in Visual Studio Code weergeven
- Microsoft Kiota-extensie : API-clients genereren
- Microsoft 365 Agents Toolkit : om declaratieve agents van Microsoft 365 te maken
Extensie instellen
Installeer de Azure API Center-extensie voor Visual Studio Code vanuit Visual Studio Code Marketplace. Installeer indien nodig andere extensies.
Notitie
Indien vermeld, zijn bepaalde functies alleen beschikbaar in de voorlopige versie van de Azure API Center-extensie. Wanneer u de extensie installeert vanuit Visual Studio Code Marketplace, kunt u ervoor kiezen om de releaseversie of een voorlopige versie te installeren. Schakel op elk gewenst moment tussen de twee versies met behulp van het contextmenu voor de knop Beheren van de extensie in de weergave Extensies.
Selecteer API Center in Visual Studio Code in de activiteitenbalk aan de linkerkant.
Als u niet bent aangemeld bij uw Azure-account, selecteert u Aanmelden bij Azure...en volgt u de aanwijzingen om u aan te melden. Selecteer een Azure-abonnement met het API-centrum (of API-centra) waaruit u API's wilt weergeven. U kunt ook filteren op specifieke abonnementen als u er veel van kunt bekijken.
API's ontdekken
API Center-resources worden weergegeven in de structuurweergave aan de linkerkant. Vouw een API Center-resource uit om API's, versies, definities, omgevingen en implementaties te bekijken.
Zoek naar API's in een API Center met behulp van het zoekpictogram dat wordt weergegeven in het item van de API-structuurweergave .
API-documentatie weergeven
U kunt de documentatie voor een API-definitie in uw API-centrum bekijken en API-bewerkingen proberen. Deze functie is alleen beschikbaar voor op OpenAPI gebaseerde API's in uw API-centrum.
Vouw de structuurweergave van API Center uit om een API-definitie weer te geven.
Klik met de rechtermuisknop op de definitie en selecteer Open API-documentatie. Er wordt een nieuw tabblad weergegeven met de Swagger-gebruikersinterface voor de API-definitie.
Als u de API wilt proberen, selecteert u een eindpunt, selecteert u Uitproberen, voert u de vereiste parameters in en selecteert u Uitvoeren.
Notitie
Afhankelijk van de API moet u mogelijk autorisatiereferenties of een API-sleutel opgeven om de API uit te proberen.
Aanbeveling
U kunt API-documentatie genereren in Markdown, een indeling die eenvoudig te onderhouden en te delen is met eindgebruikers. Klik met de rechtermuisknop op de definitie en selecteer Markdown genereren.
HTTP-bestand genereren
U kunt een .http bestand weergeven op basis van de API-definitie in uw API-centrum. Als de REST Client-extensie is geïnstalleerd, kunt u verzoeken indienen vanuit de Visual Studio Code-editor. Deze functie is alleen beschikbaar voor op OpenAPI gebaseerde API's in uw API-centrum.
Vouw de structuurweergave van API Center uit om een API-definitie weer te geven.
Klik met de rechtermuisknop op de definitie en selecteer HTTP-bestand genereren. Er wordt een nieuw tabblad weergegeven dat een HTTP-document weergeeft dat is gevuld met de API-specificatie.
Als u een aanvraag wilt indienen, selecteert u een eindpunt en selecteert u Aanvraag verzenden.
Notitie
Afhankelijk van de API moet u mogelijk autorisatiereferenties of een API-sleutel opgeven om de aanvraag te doen.
API-client genereren
Gebruik de Microsoft Kiota-extensie om een API-client te genereren voor uw favoriete taal. Deze functie is alleen beschikbaar voor op OpenAPI gebaseerde API's in uw API-centrum.
- Vouw de structuurweergave van API Center uit om een API-definitie weer te geven.
- Klik met de rechtermuisknop op de definitie en selecteer API-client genereren. Het deelvenster Kiota OpenAPI Generator wordt weergegeven.
- Selecteer de API-eindpunten en HTTP-bewerkingen die u wilt opnemen in uw SDK's.
- Selecteer API-client genereren.
Voer configuratiegegevens in over de SDK-naam, naamruimte en uitvoermap.
Selecteer de taal voor de gegenereerde SDK.
De client wordt gegenereerd.
Zie de Microsoft Kiota-extensie voor Visual Studio Code voor meer informatie over het gebruik van de Kiota-extensie.
API-specificatie exporteren
U kunt een API-specificatie exporteren uit een definitie en deze vervolgens downloaden als een bestand.
Een specificatie exporteren in de structuurweergave van de extensie:
Vouw de structuurweergave van API Center uit om een API-definitie weer te geven.
Klik met de rechtermuisknop op de definitie en selecteer Api-specificatiedocument exporteren. Er wordt een nieuw tabblad weergegeven waarmee een API-specificatiedocument wordt weergegeven.
U kunt ook een specificatie exporteren met behulp van het opdrachtpalet:
- Typ de sneltoets Ctrl+Shift+P om het opdrachtenpalet te openen.
- Selecteer Azure API Center: Api-specificatiedocument exporteren.
- Maak selecties om naar een API-definitie te navigeren. Er wordt een nieuw tabblad weergegeven waarmee een API-specificatiedocument wordt weergegeven.
M365-declaratieve agent maken
U kunt een declaratieve agent voor Microsoft 365 Copilot maken vanuit een OpenAPI-definitie in uw API-centrum. Met een declaratieve agent past u Microsoft 365 Copilot aan om te voldoen aan de unieke zakelijke behoeften van uw gebruikers. Wanneer u een declaratieve agent bouwt, geeft u de instructies, acties en kennis op om Copilot aan te passen voor uw bedrijfsscenario's.
Een declaratieve agent exporteren in de structuurweergave van de extensie:
- Vouw de structuurweergave van API Center uit om een OpenAPI-definitie weer te geven.
- Klik met de rechtermuisknop op de definitie en selecteer M365-declaratieve agent exporteren.
- Wanneer u hierom wordt gevraagd:
- Selecteer een of meer API-bewerkingen waarmee Copilot kan communiceren.
- Selecteer een werkruimtemap.
- Voer een toepassingsnaam in.
De declaratieve agent wordt gemaakt in de geselecteerde werkruimtemap. Gebruik de Microsoft 365 Agents Toolkit om de agent verder aan te passen en te implementeren.