Skip to content
This repository has been archived by the owner on Nov 5, 2019. It is now read-only.

datatogether/api

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

93 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Data Together API

GitHub Slack License

Serves the Data Together JSON API.

This component in isolation doesn't do much, but when connected to the project as a whole it provides a variety of endpoints over https, which can be used to extract information from the Data Together database.

API Documentation: https://api.archivers.co/docs/

License & Copyright

Copyright (C) 2017 Data Together This program is free software: you can redistribute it and/or modify it under the terms of the GNU Affero General Public License as published by the Free Software Foundation, version 3.0.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.

See the LICENSE file for details.

Getting Involved

We would love involvement from more people! If you notice any errors or would like to submit changes, please see our Contributing Guidelines.

We use GitHub issues for tracking bugs and feature requests and Pull Requests (PRs) for submitting changes

Installation and Local Deployment

Generating Documentation

The API documentation is OpenAPI/Swagger compliant and is generated by the spectacle node module. You will likely want to explore these docs, so you should generate them!

  1. Install spectacle with npm -g install spectacle-docs
  2. To dynamically generate API docs as you work, run spectacle -d open_api.yaml and edit open_api.yaml to see changes
  3. Generate Static docs with spectacle open_api.yaml
  4. Commit. Rinse. Repeat.

Development

Right now modifying & updating code is a huge pain, but this is at least a start.