Updates voor de REST API-ervaring aankondigen
Dit bericht is geschreven door Jessie Huang, programmamanager van het docs.microsoft.com team.
Vandaag kondigen we de release aan van twee belangrijke verbeteringen in de REST-ervaring op docs.microsoft.com:
- De preview-versie van de REST API Browser, een eenvoudige manier om REST API's te zoeken en te ontdekken die zijn ontwikkeld door Microsoft.
- REST Try It: een interactieve ervaring waarmee u REST API's rechtstreeks in uw favoriete webbrowser kunt proberen.
REST API's op één locatie ontdekken
Als u al bekend bent met een van onze bestaande API-browserervaringen, zoals die voor .NET, PowerShell, Python of JavaScript, voelt u zich meteen thuis met deze nieuwe release. Hiermee kunt u snel documentatie voor een groot aantal REST API's ophalen zonder dat u hoeft te vertrouwen op een minder gerichte zoekervaring. De API-browser is bedoeld om u snel op weg te krijgen door binnen enkele seconden de juiste API te vinden.
Als u eerder specifieke REST API-documentatie over docs.microsoft.com wilde vinden, moest u deze mogelijk zoeken via onze sitebrede zoekopdracht of een van de navigatieonderdelen op inhoudspagina's gebruiken, zoals de inhoudsopgave. Dat kan tijdrovend zijn, vooral in situaties waarin u precies weet wat u zoekt. Dat wilden we makkelijker maken.
Vanaf vandaag kunt u Microsoft REST API's op een veel efficiëntere manier ontdekken, vanaf één centrale locatie: https://docs.microsoft.com/rest/api. Selecteer een service in de vervolgkeuzelijst om alle beschikbare service-API's te vinden:
Wilt u een klik opslaan? Voor een aantal van de meest gebruikte API's kunt u altijd rekenen op Snelle filters . Als u op een van deze api's klikt, wordt direct de uitgebreide set API's voor een bepaalde service weergegeven, voor de nieuwste release:
We hebben de zoekervaring zo ontworpen dat u de benodigde API-informatie kunt vinden, ongeacht of u de exacte trefwoorden kent of niet, of zelfs als u niet weet in welke service deze zich bevindt. Standaard zoeken we in alle API's die zijn gedocumenteerd op docs.microsoft.com. Alleen wanneer een service is geselecteerd, wordt de zoekopdracht uitgevoerd binnen het bereik van die service.
Wilt u meerdere trefwoorden tegelijk zoeken? Dat kunt u ook!
Azure REST API's uitproberen in uw browser
Hebt u een Interessante Azure-API gevonden, maar weet u niet of dit precies is wat u nodig hebt om uw scenario uit te bouwen? Maakt u zich geen zorgen, want vanaf vandaag kunt u Azure REST API's rechtstreeks in uw browser proberen, op docs.microsoft.com.
U hoeft alleen maar op de groene knop Uitproberen te drukken:
Zodra u Uitproberen voor een REST API hebt geselecteerd, wordt u naar een gerichte weergave gebracht, zodat u kunt experimenteren met verschillende parameterwaarden of aanvraagbody. U kunt de context van het artikel net zo eenvoudig wijzigen met behulp van het hamburgermenu Inhoud in de linkerbovenhoek van de pagina:
We willen uw feedback
Er zijn veel verbeteringen die we op de korte termijn willen implementeren, dus deze ervaring is nog lang niet definitief. Zo schakelen we Try it niet alleen in voor Azure REST API's. We willen dat u ons vertelt hoe we onze REST-ervaring kunnen verbeteren. Open gewoon een nieuw probleem en we komen zo snel mogelijk bij u terug.
U kunt natuurlijk ook ons Twitter-account volgen voor de allernieuwste updates en meldingen.
Is het uw droom om de wereld te verbeteren voor ontwikkelaars? Kom bij ons team!