Home

Awesome

openSenseMap API

This repository contains the code of the openSenseMap API, which is the HTTP REST API used by https://opensensemap.org running at https://api.opensensemap.org. To get more information about openSenseMap and senseBox visit the before mentioned links or have a look at this video, read the API docs or the openSenseMap chapter in our documentation. openSenseMap is part of the senseBox project.

Originally, this API has been built as part of the bachelor thesis of @mpfeil at the ifgi (Institute for Geoinformatics, WWU Münster). Developers and previous maintainer include @umut0, @felixerdy, @noerw, @chk1 and @ubergesundheit.

You'll find that the repostiory uses yarn workspaces to separate the API and the database models for reuse in other projects. While the API is not published on npm, the package @sensebox/opensensemap-api-models is published from packages/models folder.

Configuration

Configuration of both the api and the models is done using mechanisms provided by lorenwest/node-config. You can find an annotated example configuration with all keys in config/config.example.json.

Development

See also: CONTRIBUTING

Running Tests

You can run the tests in containers using Docker and docker-compose.

# Run this the first time or every time you change dependencies in package.json
yarn build-test-env

yarn test

Related projects

Services

Libraries

Deployment

Technologies

Organization

Branches

Tags and Versions

Git Tags are used for Github Container Registry builds (like v1). Version number is increased by following semantic versioning. Docker images are built automatically by Github Actions for all tags starting with v all pushes to master and all pull requests against master.

Versioned container images

License

MIT - Matthias Pfeil 2015 - now