This quick start section will help you get going with a HAT PDA and start testing the API in a matter of minutes. There are a few ways to get a running HAT PDA and the approach will depend on your skills level, available time and the actual purpose.
The registration process is quick and straightforward. You can read more about how to create an account here. Normally, you should be able to get up and running with a new HAT PDA in a matter of minutes.
You can find our postman collection here. The collection is able to run using a predefined managed HAT PDA (postman.hubat.net). If you choose to use that account, please keep in mind that other developers can see the data in this HAT PDA, DO NOT write any sensitive information on this HAT PDA. If you want to avoid using a HAT PDA with other developers you can use your personal HAT PDA by replacing the following environment variables in postman:
hat— your HAT PDA address, eg.
username— the first part of the HAT PDA address, eg.
password— the password of your HAT PDA
The goal of the collection is to showcase basic operations on a HAT PDA. The collection aims to showcase how you can:
HAT is an open-source project with the full project codebase available on GitHub. With a bit of technical knowledge, it should be relatively easy to follow the steps below to setup and run the project on a localhost (if it's not, please let us know how we can improve!).
Before starting make sure the following pre-requisites are installed:
To launch HAT instance, follow these steps:
Clone HAT repository and its submodules:
git clone https://github.com/Hub-of-all-Things/HAT2.0.git cd HAT2.0 git submodule init git submodule update
Create the database:
createdb testhatdb1 createuser testhatdb1 psql postgres -c "GRANT CREATE ON DATABASE testhatdb1 TO testhatdb1"
Compile the project:
Add custom local domain mapping to your
/etc/hosts file. This will make sure that when you go to the defined address
from your machine, you will be pointed back to your own machine. E.g.:
Run the project:
sbt "project hat" "run -Dconfig.resource=dev.conf"
You're all set! Now is a good time to start getting a deeper understanding of the technology through the available guides.