- Martí Ras
How to Start Using Vottun APIs from Postman
Vottun APIs offer developers a quick and easy way to create decentralized Web3 applications (dApps) without hassle. In this article, you will see the step-by-step process on how to start calling Vottun APIs from Postman and begin using all the functionalities of the Web3 API.
Introduction to Postman
Postman is a development tool that allows sending HTTP requests and analyzing API responses. Basically, it is a tool that allows making API calls for testing purposes.
Authentication in Vottun
To make an API call to Vottun from Postman, it is first essential to authenticate with an API Key and an App ID. Follow these steps:
Registration on the Vottun Web3 Platform:
- Access the Vottun Web3 API platform.
- If you do not have an account, you can sign up using this link: https://web3.vottun.io/signup.
Generating the API Key and Obtaining the App ID:
- In the sidebar menu of the platform, select “API Keys.”
- Click on “New API Key” to create a new token, define a descriptive name, set the expiration date, choose the environment, and specify the necessary permissions.
- Save your API Key securely, as you will not be able to see it again.
- Find the App ID in the corresponding section of the dApps screen on the Vottun platform.
Postman Configuration
With your App ID and API Key in hand, follow these steps to configure Postman:
- Create a New Request (untitled request):
- Set the authorization type to “Bearer Token” and enter your API Key in the corresponding field.
- Add the header x-application-vkn with your App ID.
Now we are ready to call Vottun APIs. Let’s start with a simple example. Let’s get information about the different networks that the Vottun platform works with. To do this, go to the Start Building section in the documentation, copy the endpoint:
https://api.vottun.tech/core/v1/evm/info/chains.
Paste the endpoint into Postman and select the type of request (GET in this case)
Click on ‘Send’ and review the JSON response containing information about the different blockchain networks available on the Vottun platform.
Let’s see a more complex example.
Go to the IPFS section in the documentation, copy the endpoint for uploading a file, and configure it in Postman. This is the endpoint: https://api.vottun.tech/core/v1/ipfs/upload.
In this case, as you can see in the documentation, the API requires a set of information. We need to provide a file and the file name.
Click on ‘Send’ and the response will be the link to the file uploaded to IPFS.
With these detailed steps, you will be ready to take full advantage of Vottun’s APIs capabilities from Postman, thus facilitating the development of your own dApps in the blockchain world.