Authentication

Authenticate requests to the redu.cloud API using an API key.

Generate an API key


https://console.redu.cloud

Open API Keys:


https://console.redu.cloud/category/user/api-keys

Generate a key and copy it immediately.

API keys are only shown once after creation.

Base URL


https://api.redu.cloud/v1

Authentication header

Include your API key in the x-api-key header:


x-api-key: YOUR_API_KEY

Example: get current user

cURL


curl https://api.redu.cloud/v1/me \
  -H "x-api-key: YOUR_API_KEY"

Fetch


const response = await fetch("https://api.redu.cloud/v1/me", {
  headers: {
    "x-api-key": "YOUR_API_KEY",
  },
});
 
if (!response.ok) {
  throw new Error(`HTTP ${response.status}`);
}
 
const data = await response.json();
console.log(data);

Axios


import axios from "axios";
 
const { data } = await axios.get("https://api.redu.cloud/v1/me", {
  headers: {
    "x-api-key": "YOUR_API_KEY",
  },
});
 
console.log(data);

Python


import requests
 
resp = requests.get(
    "https://api.redu.cloud/v1/me",
    headers={"x-api-key": "YOUR_API_KEY"},
)
 
resp.raise_for_status()
print(resp.json())

Go


package main
 
import (
	"fmt"
	"io"
	"net/http"
)
 
func main() {
	req, err := http.NewRequest("GET", "https://api.redu.cloud/v1/me", nil)
	if err != nil {
		panic(err)
	}
 
	req.Header.Set("x-api-key", "YOUR_API_KEY")
 
	client := &http.Client{}
	resp, err := client.Do(req)
	if err != nil {
		panic(err)
	}
	defer resp.Body.Close()
 
	body, _ := io.ReadAll(resp.Body)
	fmt.Println(string(body))
}

Successful response


{
  "id": "usr_01HZX8YF2",
  "username": "joe",
  "email": "joe@example.com",
  "roles": ["user"]
}

Common errors

401 Unauthorized

Missing or invalid API key.


{
  "error": {
    "code": "unauthorized",
    "message": "Invalid API key"
  }
}

403 Forbidden

The API key is valid, but does not have permission to access the resource.