Skip to main content

1E SDK

API testing tools

The purpose of this page is to show how to configure several of the most popular API testing tools in order to make calls to Tachyon Consumer API.

This page will not recommend a particular tool nor will it discuss differences between versions of each tool.

Postman

Version 7.36.5 was used in this guide.

Turn off SSL certificate validation

Open Settings and on "General" tab turn off "SSL certificate cerification".

233276531.png
Setting the X-Tachyon-Consumer header field

This header fields needs to be set on the "Headers" tab ofeach request.

233276533.png
Configuring Credentials

On authorization tab, you should pick "NTLM Authentication (Beta)" and fill your credentials. You can use Username, Password and Domain or write your user name in domain\username format into the Username field.

233276532.png
Gotchas

Postman caches credentials from successful API calls. This means that you can make an API calls that will succed and then make a subsequent call with different credentials and even though these new credentials should make the call fail, it succeeds. This is due to credentials caching present in Postman.

Fiddler

Version 5.0 was used in this guide.

Enabling Windows Authentication

To turn on Windows Authentication, you should switch to "Composer", then in the "Options" tab, tick "Automatically Authenticate". This will make Fiddler use Windows Credentials of the user running it in all API calls, so there's no need to explicitly input credentials.

233276527.png
Setting the X-Tachyon-Consumer header field

Header fields can be set in "Composer" view.

233276528.png
Insomnia

Version 2020.4-2 was used in this guide.

Setting the X-Tachyon-Consumer header field

You can set the header on the "Header" tab.

233276525.png
Configuring Credentials

You should change the authentication method to NTLM, set username in domain name \ user name format and provide a password.

233276526.png