Learn about Dataswift One
Build on Dataswift One
Deploy
Developer Portal
Signing up for developer dashboard.
With the Developer Portal we provide an easy way to create and manage applications that integrate with the PDA. In short, it offers the following:
- Creating an account that can be used to manage applications
- Creating a testing account that can be used to interact with applications during testing
- Creating a new application
- Updating/editing an existing application
- Submitting the application for review
- Creating test application to test new features without affecting the application that is already available to the public
- Deleting/removing applications
- Offering support to achieve all the above either by documentation/guides or by contacting us directly
Signing up with new PDA
Account creation can be achieved by clicking
Create account at the top right corner of the Developer Portal.The fields required to create an account are:
first name– First name of the main developerlast name– Last name of the main developeremail– Email that will be used for this account. *It has to be a valid email, or else the accountverification will fail*PDA Name– A valid username. *Usernames have to start with a non-capital letter, be 4-21 characters long and must not contain special characters *terms of service– For the account creation to continue, it's vital to agree to theterms of serviceCompany– Company name is optional and can be filled in at a later point
1
Please note that email and username must be unique and not used before to create a HAT/PDS, otherwise,
2
the process will fail. Also the company name must be unique within Developers portal.
Copied!
After filling out the information needed, click
Next to create a password for the new PDA. The password must achieve a strength rating of good or above; otherwise the process will not continue. You can find our password policy here.In the next screen after clicking
Next, the Developer Portal application will ask permissions to have access to the new PDA account.Finally, click
Confirm to create the new PDA.Signing up with existing PDA
Existing
PDAs can also be used to log in. Just click Create account at the top right corner of the screen and then click the Already have a PDA? Start Here button.1
Please note that only hubofallthings.net DAs are accepted at the moment.
Copied!
Then enter the hat's username, eg for
myusername.hubofallthings.net, enter myusername, and click Next. If the PDA has been found, the "enter your password" screen will be shown; if the PDA has not been found, an error message will be shown.Whether signing up with an existing or a new PDA, an account verification will be needed via an email which is sent instantly after the successful registration.
Log in
To
log in, click Log in at the top right corner of the screen.Then enter the PDA's username, eg for
myusername.hubofallthings.net, enter myusername, and click Next. If the PDA has been found, the password screen will show. Please enter the PDA's password. If the PDA has not been found, please contact us if you believe this is an error.Onboarding
Once your email has been verified, a two-step onboarding process will start.
The first step contains information about the testing PDA that has been created and the password attached to it. A testing PDA is useful during and after the development of the application. It grants the ability to test the application in a separate PDA, rather than the main PDA that's been used to access the Developer Portal. This is to enforce a separation between the accounts that will be able to manage the application and the accounts that will be used to test the application.
The second step asks for information about the organization. It's an optional step and can be skipped, as the information can be filled in at a later point.
Create the application
You can create a new application with the blue
Create button at the top right corner of the screen in the My Apps section.A new window will appear with all the necessary information needed to create a new application:
Application name– A human-readable name of the application; could be the same with other applicationsApplication website– A URL where more information about the application can be foundApplication id– A unique application identifier. Must not contain spaces or special charactersApplication namespace– The unique application namespace. This will define the domainunder which the application will be able to read/write data. Must not contain spaces or special charactersCountry– The country where this application is developedPlatforms– The platforms this application will support. Currently, we offer 3 options:web,iOSandandroid.
For each platform you will be asked to select 2 additional fields. More specifically:
Application link– A URL that helps users learn more about the applicationCallback URI– A callback URI that will be used during authentication with the PDA
1
Please note that the new application can take up to 30 minutes to be visible in tHPDA
Copied!
Editing account information
The
Accounts Settings section holds the basic information of the user/organisation. Only the following information can be edited at any time:First name– Developers' first name, stored in theHATLast name– Developers' last name, stored in theHATPersonal website– Developers' website, stored in theHATCompany– Company name; this has to be uniqueCountry– Country in which the company is basedCompany website– Company's website URLCompany logo– Company's logo
Other information provided in this section includes:
Partner Id– Your partner Id, automatically generated on sign upUsername–HATusernameHAT URL– The full URL of theHATEmail– Email used when signing upPassword– Reset password option
Test account information
During sign up a
test account is created. The test account credentials can be found under Test roles.Please note that the test account will always be a hubat.net account.