API Documentation

Welcome to the AetherVaultCloud API. Build secure, encrypted data storage into your applications with our simple REST API. All data is encrypted before storage and indexed for fast retrieval.

Authentication

Authenticate your requests by including your API key in the x-api-key header. You can generate keys in the Dashboard.

curl -H "x-api-key: YOUR_API_KEY" https://api.AetherVaultCloud.com/api/entries

Create Entry

Store a new encrypted file or JSON object.

POST /api/entries

Parameter	Type	Description
contentREQ	Any	The data to encrypt and store.
collection	String	Folder name (e.g., "users", "logs").
filename	String	Name of the file (e.g., "data.json").

{
  "content": { "user": "alex", "score": 500 },
  "collection": "scores",
  "filename": "alex_score.json"
}

List Entries

Retrieve a paginated list of your stored entries.

GET /api/entries

Filter results by collection or search query.

GET /api/entries?collection=scores&limit=10

Get Entry

Retrieve and decrypt a specific entry.

GET /api/entries/:id

Update Entry

Update the content or metadata of an entry.

PUT /api/entries/:id

{
  "content": { "user": "alex", "score": 600 },
  "collection": "highscores"
}

Delete Entry

Permanently remove an entry.

DELETE /api/entries/:id

Code Examples

Ready-to-use examples for creating an entry in various languages.

const createEntry = async () => {
  const response = await fetch('https://api.AetherVaultCloud.com/api/entries', {
    method: 'POST',
    headers: {
      'Content-Type': 'application/json',
      'x-api-key': 'YOUR_API_KEY'
    },
    body: JSON.stringify({
      content: { user: "alex", score: 500 },
      collection: "scores",
      filename: "alex_score.json"
    })
  });

  const data = await response.json();
  console.log(data);
};

createEntry();

import requests
import json

url = "https://api.AetherVaultCloud.com/api/entries"
headers = {
    "Content-Type": "application/json",
    "x-api-key": "YOUR_API_KEY"
}
payload = {
    "content": {"user": "alex", "score": 500},
    "collection": "scores",
    "filename": "alex_score.json"
}

response = requests.post(url, headers=headers, json=payload)
print(response.json())

package main

import (
 "bytes"
 "encoding/json"
 "fmt"
 "net/http"
)

func main() {
	url := "https://api.AetherVaultCloud.com/api/entries"
	payload := map[string]interface{}{
  "content":    map[string]interface{}{"user": "alex", "score": 500},
  "collection": "scores",
  "filename":   "alex_score.json",
 }
 
 jsonData, _ := json.Marshal(payload)
 req, _ := http.NewRequest("POST", url, bytes.NewBuffer(jsonData))
 req.Header.Set("Content-Type", "application/json")
 req.Header.Set("x-api-key", "YOUR_API_KEY")

 client := &http.Client{}
 resp, _ := client.Do(req)
 defer resp.Body.Close()

 fmt.Println("Status:", resp.Status)
}

import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

public class Main {
    public static void main(String[] args) throws Exception {
        String json = "{\"content\": {\"user\": \"alex\", \"score\": 500}, \"collection\": \"scores\", \"filename\": \"alex_score.json\"}";

        HttpClient client = HttpClient.newHttpClient();
        HttpRequest request = HttpRequest.newBuilder()
                .uri(URI.create("https://api.AetherVaultCloud.com/api/entries"))
                .header("Content-Type", "application/json")
                .header("x-api-key", "YOUR_API_KEY")
                .POST(HttpRequest.BodyPublishers.ofString(json))
                .build();

        HttpResponse response = client.send(request, HttpResponse.BodyHandlers.ofString());
        System.out.println(response.body());
    }
}

using System;
using System.Net.Http;
using System.Text;
using System.Threading.Tasks;

class Program {
    static async Task Main() {
        var client = new HttpClient();
        var url = "https://api.AetherVaultCloud.com/api/entries";
        var json = "{\"content\": {\"user\": \"alex\", \"score\": 500}, \"collection\": \"scores\", \"filename\": \"alex_score.json\"}";
        
        var content = new StringContent(json, Encoding.UTF8, "application/json");
        client.DefaultRequestHeaders.Add("x-api-key", "YOUR_API_KEY");

        var response = await client.PostAsync(url, content);
        var result = await response.Content.ReadAsStringAsync();
        Console.WriteLine(result);
    }
}

 ['user' => 'alex', 'score' => 500],
    'collection' => 'scores',
    'filename' => 'alex_score.json'
];

$options = [
    'http' => [
        'header'  => "Content-type: application/json\r\n" .
                     "x-api-key: YOUR_API_KEY\r\n",
        'method'  => 'POST',
        'content' => json_encode($data)
    ]
];

$context  = stream_context_create($options);
$result = file_get_contents($url, false, $context);
echo $result;
?>

use reqwest::Client;
use serde_json::json;

#[tokio::main]
async fn main() -> Result<(), Box> {
    let client = Client::new();
    let res = client.post("https://api.AetherVaultCloud.com/api/entries")
        .header("x-api-key", "YOUR_API_KEY")
        .json(&json!({
            "content": {"user": "alex", "score": 500},
            "collection": "scores",
            "filename": "alex_score.json"
        }))
        .send()
        .await?;

    println!("Status: {}", res.status());
    Ok(())
}