API & SDK Documentation

The Aevum Zenth Conglomerate API provides programmatic access to our unified enterprise platform. Manage subsidiaries, sync cross-divisional data, deploy analytics, and integrate with your internal systems using our RESTful endpoints and official SDKs.

Authentication

Aevum Zenth uses API keys and OAuth 2.0 for authentication. You must authenticate every request to the API using your project's secret key.

API Keys

Find your API keys in the Developer Dashboard. You will need to provide the secret key in the Authorization header:

Authorization: Bearer sk_az_live_8f3a9b2c1d4e5f6a7b8c9d0e
Content-Type: application/json

Core Endpoints

SDK Installation

Official client libraries are available for all major languages. They handle authentication, retries, pagination, and type safety automatically.

npm install @aevumzenth/sdk

pip install aevum-zenth-sdk

Quickstart Examples

Here's how to fetch active divisions and trigger a data sync using the JavaScript SDK:

import { AevumZenth } from '@aevumzenth/sdk';

// Initialize client
const client = new AevumZenth({
  apiKey: process.env.AZ_API_KEY,
  region: 'eu-central-1',
});

async function syncDivisionData() {
  try {
    const divisions = await client.divisions.list({ limit: 20 });
    console.log(`Found ${divisions.total} divisions`);

    const syncResult = await client.divisions.sync('div_aero_defense_04');
    console.log(`Sync initiated: ${syncResult.jobId}`);
  } catch (err) {
    console.error('API Error:', err.message);
  }
}

syncDivisionData();

Error Handling

Aevum Zenth uses conventional HTTP response codes to indicate the success or failure of an API request. Codes in the 2xx range indicate success. Codes in the 4xx range indicate client errors, and 5xx codes indicate server-side failures.