Lambda-based API to support consuming cellular camera data via POST requests. Currently, the API only supports image payloads sent by Reconyx's servers.
The animl-ingest-api stack is a collection of AWS resources managed by the Serverless framework. When image payloads are received they are passed through to the Animl Ingest S3 bucket, managed by the Animl Ingest stack.
The Animal ingest API aims to be compatible with as many camera trap providers as possible and serve as an easier alternative to scraping image data out of email alerts, as we do in the Animl Email Relay service.
The instructions below assume you have the following tools globally installed:
- Serverless
- Docker
- aws-cli
The name of the profile must be "animl", because that's what
serverles.yml will be looking for. Good instructions
here.
git clone https://github.com/tnc-ca-geo/animl-ingest-api.git
cd animl-ingest-api/api
npm install
cd ..From project root folder (where serverless.yml lives), run the following to deploy or update the stack:
# Deploy or update a development stack:
serverless deploy --stage dev
# Deploy or update a production stack:
serverless deploy --stage prod
Animl is comprised of a number of microservices, most of which are managed in their own repositories.
Services necessary to run Animl:
Services related to ingesting and processing wireless camera trap data: