OutSystems.FileServer.Api
This is the README file for the API. It provides information on how to run the API locally and other relevant details.
Prerequisites
Getting Started
Running Locally as Console Application
- Clone the repository:
git clone https://github.com/os-adv-dev/OutSystems.FileServer.git
- Navigate to the project directory
- Restore the dependencies:
dotnet restore
- Build the project:
dotnet build
- Run the API:
dotnet run
- The API will be available at
Take a look at the launchSettings.json for details
- Add
/swagger
for documentation.
Running with IIS Express
- Clone the repository:
git clone https://github.com/os-adv-dev/OutSystems.FileServer.git
- Open the solution file in Visual Studio
- Build the solution (press F6 or go to Build > Build Solution)
- Set the startup project to the API project
- Press F5 to start debugging
- The API will be available at
Take a look at the launchSettings.json for details
Running with Docker
- Clone the repository:
git clone https://github.com/os-adv-dev/OutSystems.FileServer.git
- Navigate to the project directory
- Build the Docker image:
docker build -t outsystems-fileserver-api
- Run the Docker container:
docker run -d -p 8080:80 outsystems-fileserver-api
- The API will be available at
http://localhost:8080
Publishing (IIS)
- Navigate to the Api directory using terminal.
- Use the
dotnet publish -c release
command to publish. - Avoid to copy the
appsettings.json
file and copy the rest of the content fromPATH TO THE API\Api\bin\release\net7.0\publish\
- Paste on the destination folder configured in IIS. If the site is running maybe you need to stop first to replace the files.
- If it's necessary, change the site
appsettings.json
file. - Start the site and navigate to the swagger to test and make sure it's working.
API Documentation
The API documentation is generated using Swagger. Once the API is running, you can access the Swagger UI at http://localhost:<port>/swagger
to explore the available endpoints and interact with them.
Configuration
The API configuration can be customized by modifying the appsettings.json
file. Update the relevant settings as per your requirements.
License
This project is licensed under the MIT License.