Step 2: Test Authentication

Once you have the username and password for your NAPINAPI - Normalized API - a loosely coupled API; fields may be added to our services and responses as the API evolves, and a client must be able to safely ignore fields and data that are not expected. NAPI can help automate your business processes by performing tasks such as Identity Verification, Business Verification, Document Verification and AML Watchlist. account, 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, at 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 Base64 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
//Example Username: JoeNapoli_API_Demo, Example Password: 05uZuPRCyPi!6
var truliooClient = new TruliooApiClient("JoeNapoli_API_Demo", "05uZuPRCyPi!6");
var responseString = await truliooClient.Connection
    .TestAuthenticationAsync();
//Example Username: JoeNapoli_API_Demo, Example Password: 05uZuPRCyPi!6
ApiClient apiClient = new ApiClient();
apiClient.setUsername("JoeNapoli_API_Demo");
apiClient.setPassword("05uZuPRCyPi!6");
ConnectionApi connectionClient = new ConnectionApi(apiClient);

//testAuthentication
String testResult = connectionClient.testAuthentication();

//testAuthenticationAsync
connectionClient.testAuthenticationAsync(new ApiCallback<String>() {
    @Override
    public void onFailure(ApiException e, int statusCode, Map<String, List<String>> responseHeaders) {
        Logger.getLogger(SdkJavaV1Sample.class.getName()).log(Level.SEVERE, null, e);
    }
    @Override
    public void onSuccess(String result, int statusCode, , Map<String, List<String>> responseHeaders) {
        System.out.println(result);
    }
    @Override
    public void onUploadProgress(long bytesWritten, long contentLength, boolean done) {
        //To change body of generated methods, choose Tools | Templates.
    }
    @Override
    public void onDownloadProgress(long bytesRead, long contentLength, boolean done) {
        //To change body of generated methods, choose Tools | Templates.
    }
});

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 Messages

If you aren't receiving a successful response of the string your username visit our Error Page here to diagose.


Did this page help you?