Authentication

As stated in the pre-requisites section, you should have received a NAPI user account with username and password. You can use the Test Authentication endpoint to check that they're working. The only thing you need to provide in this request is an authorization header, as shown below. To generate the "ACCESS_TOKEN" portion of the header, combine your username and password into username:password and run the resulting string through Base64Base64 - Base64 is a group of similar binary-to-text encoding schemes that represent binary data in an ASCII string format by translating it into a radix-64 representation. Trulioo uses it for our ACCESS_TOKEN and encoding our images for document verification. encryption. Alternatively, you can use a program such as SOAPUI or Postman to construct the authorization header for you.

Request

GET <<endpoint>>/connection/v1/testauthentication
Authorization: Basic ACCESS_TOKEN

Response

Hello JoeNapoli_API_Demo

You should receive a response containing your username, as shown above. The most common reasons for an error response are:

  • The authorization header isn't set properly. It should be a Base64Base64 - Base64 is a group of similar binary-to-text encoding schemes that represent binary data in an ASCII string format by translating it into a radix-64 representation. Trulioo uses it for our ACCESS_TOKEN and encoding our images for document verification.-encrypted Basic AuthenticationBasic Authentication - Basic Authentication uses standard fields in the HTTPS request header to avoid the need for handshakes. The header is "Authorization: Basic ACCESS_TOKEN” Where ACCESS_TOKEN is “username:password". header.
  • The spelling is incorrect.
  • The wrong credentials were used.

Ensure that you are setting the authorization header correctly, using the right username/password without any typos.

🚧

Error Message

If you aren't receiving a successful response of your username visit our Error Page here to diagnose. Please also ensure you are using the correct base URLbase URL - This is either https://api.globalgateway.io or https://api.globaldatacompany.com depending on your account set up. All API calls, for example, {baseURL}/connection/v1/sayhello/ follow the same syntax and act the same between both base URLs. If you are unsure which base URL you should be using to access Trulioo's API, please contact [email protected].


Did this page help you?