Een TypeSpec-bestand genereren

Met Dev Proxy kunt u een TypeSpec-bestand genereren op basis van de onderschepte API-aanvragen en -antwoorden. Met behulp van Dev Proxy kunt u snel een TypeSpec-bestand voor een bestaande API maken en profiteren van de hulpprogramma's die TypeSpec ondersteunen.

Een TypeSpec-bestand genereren met behulp van Dev Proxy:

1. Schakel in het configuratiebestand de TypeSpecGeneratorPlugin invoegtoepassing in:

   {
     "plugins": [
       {
         "name": "TypeSpecGeneratorPlugin",
         "enabled": true,
         "pluginPath": "~appFolder/plugins/dev-proxy-plugins.dll"
       }
     ]
     // [...] shortened for brevity
   }
   

2. Configureer eventueel de invoegtoepassing in het configuratiebestand:

   {
     "typeSpecGeneratorPlugin": {
       "$schema": "https://raw.githubusercontent.com/dotnet/dev-proxy/main/schemas/v1.0.0/typespecgeneratorplugin.schema.json",
       "ignoreResponseTypes": false
     }
     // [...] shortened for brevity
   }
   

3. Voeg in het configuratiebestand aan de lijst van te observeren URLs de URL van de API toe waarvoor u een TypeSpec-bestand wilt genereren.

   { 
     "urlsToWatch": [
       "https://api.example.com/*",
     ]
     // [...] shortened for brevity
   }
   

   Aanbeveling

   Als u betere TypeSpec-bestanden wilt maken, kunt u een lokaal taalmodel gebruiken met Dev Proxy. Met behulp van een lokaal taalmodel genereert de TypeSpecGeneratorPlugin duidelijkere bewerkings-id's en beschrijvingen, waardoor u een beter uitgangspunt voor uw TypeSpec-bestand krijgt. Zie Een lokaal taalmodel gebruiken voor meer informatie.

4. Dev Proxy starten:

   devproxy
   

5. Begin met het opnemen van aanvragen door op r

6. Voer de aanvragen uit die u wilt opnemen in het TypeSpec-bestand

7. Opnameverzoeken stoppen door op te drukken s

8. Dev Proxy genereert een TypeSpec-bestand en slaat het op in een bestand in de huidige map. Dev Proxy noemt het bestand na de hostnaam van de API, gevolgd door de huidige datum en tijd, bijvoorbeeld: api.example.com-20231219091700.tsp

Volgende stappen

Meer informatie over de TypeSpecGeneratorPlugin.