Backend User Guide

A backend user guide for the VORJ beta release

URL

https://api.vorj.app/main/v2/docs

A valid API key or JWT token is required to use the API. Accounts can only be created through the frontend.

Purpose of this guide

Warning: VORJ is currently beta

• This API is not meant for production use, currently beta.

• You, the user, accept all responsibility for the use of the VORJ API.

• Through the use of the API you are agreeing to the terms of service and privacy policy of VORJ.

• The Vechain Foundation San Marino nor any other entity associated with Vechain nor VORJ accept any responsibility associated with the use of VORJ.

• All smart contracts created and deployed through VORJ are done so through the VORJ deployment wallet and thus these smart contracts are owned and controlled by VORJ, unless they are transferred by the user to another wallet.

• The digital assets, either fungible or non-fungible, that are created as part of the smart contracts are minted into your own self-custody wallet, through the provided API endpoints, and thus the digital assets are owned and controlled by the private key holder of that wallet.

The purpose of this guide is to provide a first time VORJ user with the steps required to create an account, organization, project and API key to start using the VORJ API endpoints.

Every endpoint described in this document should be prefixed by the/main/v1

API Authorization

Most of the APIs offered by VORJ require a valid JWT token or API key to be passed through the Authentication header. As a first time user of the API there is a requirement to populate the JWT token in order to generate an API key. A returning user can provide their previously generated API key. The JWT token should be placed into the bearerAuth input box and the API Key should be placed into the apikeyAuth input box.

The user should securely manage and store their API keys once it is generated and presented to the user. In the event of losing an API key the old one can be deleted, via the endpoint DELETE /projects/apikey, and a new one can be generated by the user through the endpoint POST /projects/apikey, see creating an API Key section for further details.

Create and verify an account

Before you can proceed you first need to create and verify an account through the frontend. Follow the steps here.

Create an organization and project

Once you have created your account you need to create an organization and project. Follow the steps here.

Allocate resources to your project

Make sure to allocate resources to your project. Follow the steps here.

The network of the project determines the network of the API key. In other words, a testnet API key cannot be used to query mainnet.

Create an API key

Go to the Account Management page, via your avatar. Go to the API keys tab and create an API with the permissions of your choice. Copy and securely store the API key value, VORJ does not store the API key.

API Keys are generated in VORJ, they are not stored within VORJ.

How to use the API key

Go to https://api.vorj.app/main/v2/docs press the Authorize button and enter the API key value you copied and or stored into the apiKeyAuth field. This will now enable you to use several of the endpoints. Unlocked endpoints are shown by a locked lock symbol.