v1.0

Quick Start

You can interact with the API through HTTP requests from any language. In this section, we discuss the ways to access quantum entropy using QxEaaS.

Fetching the access token from QxEAAS is the first step before utilizing the entropy for any use case.

To use QxEaaS's Quantum Entropy, you need an access token. Here are the steps for getting the access token in QxEaaS's platform:

Generate an Access Token

Navigate to the API key page in the dashboard here
Assign a name to the token to help you distinguish between different tokens.
Select the expiration period. This determines when the token will expire and needs to be replaced.
Click the “Generate token” button.

The next step is to prepare the API tokens such that any application can fetch the quantum entropy successfully.

The code snippets below use API Tokens stored as variables. The best practice is to store API Tokens as environment files and read from them at runtime.

Setting up Environmental Files for API Token

Create a .env file in the project environment,
Place relevant data inside it. In our case, store the API Token.
ACCESS_TOKEN=your token here
Load the .env file.
Assign to local variables.

Code Snippets for Popular Languages :

Python :

1import os
2from dotenv import load_dotenv
3token = os.environ.get("ACCESS_TOKEN")
4size = #required-size-for-your-application
5# Define the endpoint
6url = f'https://api-qxeaas.quantumemotion.com/entropy'
7# Define and submit the request
8headers = { 'Authorization': f'Bearer {token}'}
9querystring = { 'size': size }
10response = requests.get( url, headers=headers, params=querystring)
11response = response.json()
12print('response =>', response)

JavaScript :

1require('dotenv').config();
2const axios = require('axios')
3let token= process.env.ACCESS_TOKEN
4let size= //required-size-for-your-application
5let url = 'https://api-qxeaas.quantumemotion.com/entropy?size={size}'
6axios({
7    method: 'get',
8    url,
9    headers: {
10        Authorization:
11    }
12}).then(function (response) {
13    // console.log(response.data)
14}).catch(function (error) {
15    // console.log(error)
16})

Rust :

1use dotenv
2use reqwest
3use serde::Deserialize;
4#[derive(Debug, Deserialize)]
5struct Response {
6    pub random_number: String,
7    pub message: String
8}
9fn main() -> Result<(), reqwest::Error> {
10    dotenv().ok(); // Load environment variables from .env file
11    let access_token = std::env::var("ACCESS_TOKEN")?;
12    let size = // Replace with the required size for your application
13    let url = format!("https://api-qxeaas.quantumemotion.com/entropy");
14    let client = reqwest::Client::new();
15    let mut headers = reqwest::header::HeaderMap::new();
16    headers.insert(
17        reqwest::header::AUTHORIZATION,
18        format!("Bearer {}", access_token).parse()?,
19    );
20    let params = [("size", size.to_string())];
21    let response = client
22        .get(url)
23        .headers(headers)
24        .query(&params)
25        .send()?
26        .json::<Response>()?;
27
28    println!("response => {:?}", response);
29    Ok(())
30 }