Updates voor de REST API-ervaring aankondigen

Dit bericht is geschreven door Jessie Huang, Program Manager in het docs.microsoft.com team.

Vandaag kondigen we graag 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 door Microsoft zijn ontwikkeld.
  • REST Probeer het- een interactieve ervaring waarmee u REST API's rechtstreeks in uw favoriete webbrowser kunt uitproberen.

REST API's op één locatie detecteren

Als u al bekend bent met een van onze bestaande API Browser-ervaringen, zoals die voor .NET, PowerShell, Python of JavaScript, voelt u zich meteen thuis met deze nieuwe release. Hiermee kunt u snel documentatie krijgen voor een groot aantal REST API's zonder dat u hoeft te vertrouwen op een minder gerichte zoekervaring. De API-browser draait allemaal 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 wilt vinden, moet 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. We wilden dat 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:

Discover REST APIs by selecting products

Wilt u een klik opslaan? Voor sommige van de meest gebruikte API's kunt u altijd rekenen op snelle filters . Als u op een van deze api's klikt, wordt de uitgebreide set API's voor een bepaalde service direct weergegeven voor de nieuwste release:

Discover REST APIs via in-page quick filter

We hebben de zoekervaring zo ontworpen dat u de benodigde API-informatie kunt vinden, ongeacht of u de exacte trefwoorden kent of zelfs als u de service waarin deze zich voordeed. Standaard zoeken we in alle API's die worden beschreven op docs.microsoft.com. Alleen wanneer een service is geselecteerd, vindt de zoekopdracht plaats binnen het bereik van die service.

Searching REST APIs by a single keyword

Wilt u meerdere trefwoorden tegelijk zoeken? Dat kun je ook!

Searching REST APIs by multiple keywords

Azure REST API's uitproberen in uw browser

U hebt een interessante Azure-API gevonden, maar weet niet of het helemaal is wat u nodig hebt om uw scenario uit te bouwen? Maak u 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:

REST Try It - Launching the experience

Zodra u Try It 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:

REST Try It - Changing the article context

We willen uw feedback

Er zijn veel verbeteringen die we op korte termijn gaan implementeren, dus deze ervaring is niet alleen definitief, dus we zullen Proberen niet alleen inschakelen 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!