Travel Mate Server (Project: Nomad)

Django 2.0 server for Travel Mate

Contribute

• For new feature request in the app, open a new feature request on the main repository
• For reporting bug in existing APIs, open a new issue on this repository

Local setup instructions

• Clone the project from source

git clone https://github.com/project-travel-mate/server && cd server

• Setup virtual environment

pip install virtualenv
virtualenv venv --python=python3.6
source venv/bin/activate

• Install all dependencies

pip install -r requirements.txt

• Setup Postgres database and user (assuming Postgres is already installed on system; See postgres setup instructions)

$ sudo -u postgres createuser nomad
$ sudo -u postgres createdb nomad

$ sudo -u postgres psql
psql=# alter user nomad with encrypted password 'pass';
psql=# grant all privileges on database nomad to nomad ;

• Database migrations

python manage.py makemigrations
python manage.py migrate

• Run Tests

python manage.py test

• Finally! Run server

python manage.py runserver

Open localhost:8000

Working with authenticated APIs

You would need to have a registered user, with which you can generate a authentication token. Follow the following steps to generate a token (You can download Postman client to make the following POST calls) Reference: TokenAuthentication API docs

• Make a POST call to /api/sign-up with 4 form-data body objects: email, password, firstname, lastname. You should get "Successfully registered" response with 201 status code.
• Make a POST call to /api/sign-in with 2 form-data body objects: username (which is your email Id you used for sign up), password. You will get a token in JSON response, store it somewhere.
• For making any subsequent request, use the above token by sending it as an "Authorization HTTP Header", eg: Authorization: Token <your token>