We currently support a single authentication scheme, which we call the "simple" approach.

Simple Authentication Overview

Supply your appId and appKey as part of the request either via HTTP header. The appId is the unique ID of your application and is immutable. The appKey is something you can and should refresh periodically. Both are available on the My Organizations page of Dash by Arcadia.

To authenticate, pass in your appId and appKey in the request header. This is the standard HTTP Basic authentication scheme with your appId as the username and appKey as the password. You simply format the two together as the string appId:appKey and base64-encode it. Then add it as the Authorization HTTP Header. The resulting header will look like this:

Authorization: Basic QWxhZGRpbjpvcGVuIHNlc2FtZQ==

Most languages and REST client libraries have helper utilities to make adding this a snap.

Authentication Examples

Here are examples of authenticating to the Arcadia API in various languages and frameworks. For these examples, we'll assume that our app id is APP_ID and our app key is APP_KEY. We'll make a simple request to the Echo Hello endpoint.

> curl -u APP_ID:APP_KEY https://api.genability.com/rest/echo/hello
{"status":"success","count":1,"type":null,"results":["Hello World","Hello World!"]}

Quick Start Resources

Get Your Credentials

Find your appId and appKey on the My Organizations page of Dash by Arcadia.

Java Client Library

Use our official Java client library for easier integration and automatic authentication handling.