Synopsis

The Pet Adoption API is a project using the MEAN stack. The database and API are currently hosted in Azure Platform (via Mlab and Bitnami). Image assests are stored with Amazon S3.

Motivation

Nobody likes to see animals be put down due to overcrowding at animal control centers and shelters. We would like to see animals at these facilities be adopted at a much higher rate, and for those animals who were lost and found, for their rightful owners to be reunited with them once more. We would like to thank the City of Lady Lake for their wonderful contribution to the project, as they are the project's pilot city. For that, we are ever grateful!

Installation

npm install or yarn install

Docker

If you are new to containers, run through the Docker hello world here: https://docs.docker.com/engine/tutorials/dockerizing/

To use Docker Compose to run the PetApi and Mongo services together:

1. Look at the instructions in DEPLOY.md.
2. ./start_services.sh or docker-compose up --build -d
   • ./stop_services.sh or docker-compose stop

or

1. npm run start-auto-update
   • npm run stop-auto-update to stop auto-updates
2. npm run docker

TODO / Warning - the mongo container is being started without the --auth flag, which probably makes it less secure than you want.

API Reference

Current API location:

• pets.codefororlando.com/api/v1/
• pets.codefororlando.com/api/v2/ (for reduced response data)
• The subdomain (pets.codefororlando.com) will change in the upcoming weeks to: petadoption.codefororlando.com

:xxxxx = dynamic field that must be specified within the endpoint itself

Method	Endpoint	Notes
GET	/list	will show all saved species
GET	/list/:species	ex: '/list/dog' will show all saved dog species
GET	/list/:species/:pageNumber	paginated route for list/:species endpoint
GET	/model/:species	provides JSON of model layout and meta data for species
GET	/options/:species	JSON of all preselected options for given species
GET	/options/:species/:option	JSON of given option for a given species
GET	/options/:species/:option/:pageNumber	JSON of given option for a given species in pages. Page size defaults to 10. This can be changed via query argument (i.e. "/options/dog/breed/1?pageSize=15")
GET	/schema/:species	returns JSON representation of a schema. Currently includes dog and cat schema
GET	/species	JSON array of possible species
POST	/query	will match given parameters
POST	/query/:pageNumber	will match given parameters with paged results
POST	/remove/:species	deletes pet as specified by petId or petName
POST	/save/:species	fields will be saved as provided. Must match schema definition and should be of multipart/form-data. Responds with saved animal data
POST	/save/:species/json	fields will be saved as provided. Must match schema definition and should be of application/json Content-Type. Responds with saved animal data
POST	/save/:species/model	updates global model of pet in addition to saving data. Must match model format and should be of application/json Content-Type. Responds with saved species data
POST	/create/:species/model	creates a new species with provided fields. Should be of application/json Content-Type. Responds with saved species data
POST	/remove/:species/model	removes specified species

Queries

Additional POST fields you can set:

Name	Type	Description
ignoreCase	(String) Array	Allows the fields specified to ignore casing
matchStartFor	(String) Array	Requires the fields specified in the array to match starting from the beginning (prepends a '^' line start regex meta-character)
matchEndFor	(String) Array	Requires the fields specified in the array to match from the ending (appends a '$' line end regex meta-character)
properties	(String) Array	Will only supply fields specified in array
pageSize	Number	Defaults to 10 (only meaningful when making paged query)

Additional GET request parameters you can set:

Name	Type	Description
pageSize	Number	Defaults to 10 (only meaningful when making paged query)
properties	(String) Array	Will only supply fields specified in array. ex: ?properties=['species','petName','sex'] (Must not include spaces between field names)

More Notes

• api/v2 will only send values for request animals.
• api/v1 will send the value for an animal property as well as an example, default value, type, etc. as available.

Developer Notes

• gulp-utils provides easy compilation of javascript, stylus, and pug/jade files.
  • you can can read more about how it works on its github repo
  • gulp --tasks shows a list of all possible tasks, but you'll probably only want to use:
    • gulp build-webpack (for compiling web-interface js)
    • gulp pug-html (for angular template files)
    • gulp stylus (for style overrides)
• To run the tests, npm run test
• See CONTRIBUTING.md for contribution guidelines

Contributors

If you would like to join the API group, our contact info is below. You can also check out the other projects Code for Orlando has been working on @ (https://github.com/cforlando) and (http://codefororlando.com/)

Luis Moraguez (lmoraguez@kissimmee.org) - Slack (@lmoraguez) - API Group Lead
Eric Fisher (EricJFisher@Live.com) - Slack (@ericjfisher)
Andrew Studnicky (a.j.studnicky@gmail.com) - Slack (@studnicky)
Khalid Hoffman - Slack (@khalidhoffman)
Jim Sandridge - Twitter (@zero_map)
Tim Ferrell - Twitter (@ferrell_tim)

License

Project is governed by the MIT License