EAAS REST API

Overview

The EAAS REST API will allow an application to retrieve entropy from the Real Random EAAS Server. The API requires authentication and one must first obtain an OAuth2 ID and secret in order to access the api.

There are three main areas of the api:

1. Authentication – Using the OAuth2 ID and Secret, obtain a token to access the EAAS Server
2. Get Entropy – Retrieve an Entropy JSON object from the EAAS Server
3. Publish Entropy – Publish Entropy to the EAAS Server

Authentication

• url: https://auth.realrandom.co/o/token/
• request type: POST
• data: grant-type=client_credentials
• returns: JSON formatted text containing bearer token
• example: curl -s -X POST -u “id:secret” -d “grant-type=client_credentials” https://auth.realrandom.co/o/token/

Get Entropy

• url: https://api.realrandom.co/api/entropy/
• request type: GET
• header fields:
  • authorization: Bearer access-token
  • content-type: application/json
• returns: JSON formatted text containing entropy