elhini

elhini API Reference

Comprehensive documentation for our quantum AI and enterprise infrastructure APIs.

1. Authentication

API Keys

Use your API key as a Bearer token in Authorization headers. Each tenant receives unique cryptographic keys with role-based permissions. 


Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

OAuth 2.0

For enterprise integrations, use OAuth 2.0 with JWT tokens. Refresh tokens are valid for 7 days with automatic rotation. 


POST /auth/token
{ "grant_type": "client_credentials" }

2. API Endpoints

Quantum AI Models

Method Endpoint Description
GET /api/v1/models List available quantum AI models
POST /api/v1/models/train Initiate quantum model training job

Blockchain Services

Method Endpoint Description
POST /api/v1/smart-contracts Deploy Ethereum smart contract

3. Example Requests

Train Quantum Model


POST /api/v1/models/train
{
    "model_id": "qai-001",
    "dataset_uri": "s3://elhini-data/quantum-training.zip",
    "qubits": 128,
    "epochs": 10
}

Initiates quantum model training with specified parameters. Returns job ID for tracking.

Deploy Smart Contract


POST /api/v1/smart-contracts
{
    "contract_type": "erc-721",
    "abi": "...",
    "bytecode": "...",
    "provider": "ethereum"
}

Deploys a smart contract to the specified blockchain network. Returns deployment status and transaction hash.

4. Error Handling

401 Unauthorized

Missing or invalid API credentials. Ensure you're using a valid Bearer token in Authorization headers.

429 Too Many Requests

Rate limit exceeded. All endpoints are limited to 5,000 requests per minute. Use enterprise plan for higher limits.

5. SDK & Libraries

Python SDK

Install via pip with quantum-safe cryptographic bindings.

pip install elhini-sdk

Node.js SDK

Quantum-optimized JavaScript bindings for web3 development.

npm install @elhini/sdk