/innovate-eugene-api

Used for the asset inventory open-data project.

Primary LanguageJavaScriptGNU General Public License v3.0GPL-3.0

innovate-eugene-api

To get live help and debug information visit https://api.innovateeugene.com/api or https://api.innovateeugene.com/ for more information.

Please see the asset-inventory project for why this project is needed.

An important note is the short list of vendor modules and libraries. It's easy to do slap on another NPM but before you do, create an issue on github and give the leadership a chance to approve the changes. Otherwise, lets keep this project as clean and close to the metal as possible.

Clone The Project

Make sure you setup your SSH correctly!

git clone git@github.com:EugTech/innovate-eugene-api.git

Important

Make sure you create a DATA and SECRET folder before you try to run any scripts.

mkdir DATA
cd DATA
mkdir SECRET

** READ THE README's! :-)

MySQL

Make sure you have a file called mysql.json in the DATA/SECRET folder! Example:

{
    "host": "127.0.0.1",
    "port": 3306,
    "user": "mydbuser",
    "password": "mypassword",
    "database": "asset-inventory"    
}

Get and ID and PASSWORD from a system admin. Open an issue on github if need be.

TODO

This is quick running to do list of items that should be moved to the github issues list. However it would seem as only the people actually using the code are the ones doing the todo list. :-)

  • Update Issues!
  • Build SQL tables
  • Proof Airtable sync data
  • External Documentation
  • Self discovery
  • Self documenting documentation

Testing the API

Checkout API Tester and use the enpoint https://api.innovateeugene.com/api and the request body of {"service":"data","view":"AllAssets"} .

There are many API testers out there. It's all REST so just pick your favorite testing tool and go with it.