https://github.com/defra/fws-api
FWIS replacement serverless api
https://github.com/defra/fws-api
Last synced: about 1 year ago
JSON representation
FWIS replacement serverless api
- Host: GitHub
- URL: https://github.com/defra/fws-api
- Owner: DEFRA
- License: other
- Created: 2019-01-24T08:03:42.000Z (over 7 years ago)
- Default Branch: master
- Last Pushed: 2025-05-02T13:31:20.000Z (about 1 year ago)
- Last Synced: 2025-05-02T13:49:59.015Z (about 1 year ago)
- Language: JavaScript
- Size: 888 KB
- Stars: 4
- Watchers: 12
- Forks: 1
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
[](https://sonarcloud.io/dashboard?id=DEFRA_fws-api)[](https://sonarcloud.io/dashboard?id=DEFRA_fws-api)
# FWS-API
This repository contains the serverless backend services for the **FWIS replacement API** and the **FWIS management tool (FWS-app)**.
## Prerequisites
- **Node.js 20** or higher
- Appropriate API keys and environment variables (see below)
## Setup
1. Install dependencies:
```bash
npm install
```
2. API keys can be found in **fws-db**. Connection details are available in the config files (see `./lib/config.js` for more information).
3. Ensure you have the required environment variables (see below).
## Environment Variables
Environment variables are critical for the correct functioning of the API. These variables can be found in a `.profile` file stored in GitLab: [GitLab: FWS-config](https://gitlab-dev.aws-int.defra.cloud/flood/fws-config).
You can check the required environment variables in `./lib/config.js`, which contains validation logic for them.
### Example environment variables:
```bash
export FWS_ENV_NAME="env-name"
export FWS_LAMBDA_ROLEL="lambda-connection-role"
```
Ensure all required environment variables are configured correctly before running the project.
## Running Tests
To run tests, use the following commands:
- **Run both linter and unit tests:**
```bash
npm run test
```
- **Run only unit tests:**
```bash
npm run unit-test
```
Auto tests for this project can be found at: [GitHub: DEFRA/fws-tests](https://github.com/DEFRA/fws-tests).
## API Status Codes
The following status codes are returned by the API:
- **200 Created**: The request was successful, and a new resource was created.
- **401 Unauthorized**: The API key is invalid or missing.
- **403 Forbidden**: The request is valid but the API key is not authorized to access this resource with an explicit deny.
- **500 Internal Server Error**: An error occurred on the server.
## Contributing
We welcome contributions to this project. Please follow these steps:
1. Before submitting a pull request, read the [Contribution Guidelines](/CONTRIBUTING.md).
2. Ensure your code adheres to the coding standards and has appropriate test coverage.
3. Submit your pull request, and ensure all automated tests pass.
## Additional Information
- **Documentation**: Ensure your changes are documented appropriately. Any significant changes should be reflected in this README or other documentation.
- **API Usage**: For usage examples and further API documentation, see the related documentation in the repository or project wiki.
## Licence
THIS INFORMATION IS LICENSED UNDER THE CONDITIONS OF THE OPEN GOVERNMENT LICENCE found at:
The following attribution statement MUST be cited in your products and applications when using this information.
>Contains public sector information licensed under the Open Government licence v3
### About the licence
The Open Government Licence (OGL) was developed by the Controller of Her Majesty's Stationery Office (HMSO) to enable information providers in the public sector to license the use and re-use of their information under a common open licence.
It is designed to encourage use and re-use of information freely and flexibly, with only a few conditions.