Step 1 - Download the Swagger CodeGen 2.2.3 jar file

Step 2 - Download the OpenAPI specification Ed-Fi-Assessment-Data-Collection-API-v2-0.json for the Assessment Data Collection API

Step 3 - Create a folder on your local computer. (c:\SwaggerCodeGen for the purposes of this exercise)

Step 4 - Copy the swagger-codegen-cli-2.2.3.jar into the c:\SwaggerCodeGen folder 

Step 5 - Copy the downloaded Ed-Fi-Assessment-Data-Collection-API-v2-0.json file into the c:\SwaggerCodeGen folder

Step 6 - Open a PowerShell window and navigate to the c:\SwaggerCodeGen folder


Step 7 - Run this command in the PowerShell window

java -jar .\swagger-codegen-cli-2.2.3.jar generate -l aspnet5 -i .\Ed-Fi-Assessment-Data-Collection-API-v2-0.json

Step 8 - Open the IO.Swagger.sln solution file created

Step 9 - Inspect the controllers and models .cs files created in the solution

Step 10 - Compile the solution in Visual Studio


Step 11 - Start the solution in Visual Studio to view the Swagger UI


  • No labels