Links
Comment on page

Getting Started Postman Collection

This page covers importing and running the VDP API collection in Postman
You need to an Application with the basic DID and Credential scopes to run the collection. Please consult the guide section on Applications for details on managing platform Applications. You will also need to have Postman installed. See the Download page for you Operating System.

Import Postman Collection

This Postman collection is meant to get you quickly up and running and familiarized with the basics of the Verifiable Data Platform API.
VDP-Getting-Started.postman_collection.json
25KB
Code
You can import this into Postman with File -> Import.
Click on File -> Import to import a .JSON collection
Click on File -> Import to import a .JSON collection
From there, you will be presented with an area to drag and drop the Postman collection JSON file, or click on the area and select the VDP-Getting-Started.postman_collection.json file.
Select JSON Postman collection to run it
Select JSON Postman collection to run it
You will be shown a confirmation window. Click on the Import button to proceed.
Confirmation Page for Importing Postman Collection
You will then have the Postman collection imported.
Verifiable Data Platform collection imported into Postman
Next we will cover how to set up the variables to start using the API.

Manual Client Credentials Authentication

Once you have the Postman Collection imported. We will need to set the CLIENT_ID and CLIENT_SECRET to be able to authenticate with the Verifiable Data Platform API.
Setting Collection Variables to Run API
Once you have created an Application to run the Postman collection, you can copy-paste the Application client credentials into the collection variables. In the Verifiable Data Platform, click on Applications and then copy the CLIENT_ID and CLIENT_SECRET of the application you created.
Copying the Client ID and Secret from the application
Copying the Client ID and Secret from the application

Authenticating with Application Environment

Alternatively you turn off the collection variables and download the Application's environment file. Go to the bottom of the Application details page.
Postman Environment File from Application details in the Verifiable Data Platform
Postman Environment File from Application details in the Verifiable Data Platform
Choose Import -> Files and select or drop the postman-environment-details.json file to import it into Postman.
Importing
When imported, select the imported environment for the collection to run with the associated client credentials.

Postman Collection Functionality

To run the collection, click on the three dots next to "VDP Getting Started", and then click on "Run Collection.
Navigating to running the collection.
Navigating to running the collection.
To run the entire collection, right-click the Collection and choose Run Collection to run all the endpoints in order.
Running the Getting Started Postman Collection
Running the Getting Started Postman Collection
The Postman collection calls some basic network requests to the VDP API:
  • First obtains an access token for the application
  • Queries and resolves the default did:web
  • Issues and verifies a sample Verifiable Credential with standard endpoints
  • Issues and verifies a sample Verifiable Credential with platform convenience endpoints