Introduction

Postman is an API platform for developers to design, build, test and iterate their APIs. It is an HTTP client that tests HTTP requests, utilizing a graphical user interface, through which different types of responses are returned that need to be subsequently validated. This article describes how to use Postman with Votiro.

Prerequisites

Install Postman by downloading one of the following:

The Postman app from Download Postman.

The Postman portable app from Postman™ portable.

Procedure

Generating a Service Token

Generate a Service Token. Go to Settings > Service Tokens > Create New :

Select the token Type:

Connector - Basic integration. Allows authentication for uploading files procedure.

Developer - Advanced integration. For all available APIs. Handle it with caution.

Enter a name for the new token under Issued To.

Set Expiration Time

Press CREATE:

Copy and save the token string that appears on this page.

WARNING!

Save the token string. This page will only appear once.

Press OK to close the Token window.

Postman Setup

In the Postman app, go to Workspaces > My Workspace and press New:

The Create New window opens. Select HTTP Request:

Press the Settings icon:

The Settings window opens. To ensure that http requests will go through even if your VA is using a self-signed certificate, toggle SSL certificate verification to OFF:

Close the Settings window.

Under the Untitled Request dropdown box, select POST:

In the Enter request URL box, enter your VA FQDN in the following format:

https://<VA-FQDN>/disarmer/api/disarmer/v4/upload

For example:

Select the Authorization tab and under the Type dropdown, select Bearer Token:

Select the Headers tab.

10.

In the first row of the Key column, start to type Content until a dropdown list appears. Then select Content-Type from the dropdown list:

11.

In first row of the Value column, start to type multipart until a dropdown list appears. Then select multipart/form-data from the dropdown list: