API CONTROL PLANE

● OPERATIONAL | 02/20/2025 14:32:17 UTC
Node ID: Node-CH-03 Version: v1.0 / v1.1-beta Last Check: 2025-02-20 14:32:17 UTC

Central API Documentation

Main gateway for all infrastructure management operations. Provides versioned endpoints with centralized rate limiting and authentication controls.

API Versions

Stable Release

v1.0 — Production ready, fully documented

Beta Release

v1.1-beta — New features under testing

Rate Limiting

1000 req/min per API key | Burst: 100 req/sec

Rate Limit Headers

Response headers indicate remaining quota and reset timing:

// Check API key validity
curl -X POST https://api-v1.ventocloud.online/v1/auth/validate -H "X-API-Key: sk_live_a1b2c3d4e5f6"
-H "Content-Type: application/json"
-d '{"purpose": "resource_access"}'
// Response Headers:
// X-RateLimit-Limit: 1000
// X-RateLimit-Remaining: 985
// X-RateLimit-Reset: 1737393137

Endpoint Catalog

Endpoint Method Description
/v1/auth/validate POST API key validation and quota check
/v1/status/health GET Service health endpoint
/v1/logs/request GET Access log retrieval
Warning: Do not include authentication credentials in request bodies. Use X-API-Key header only.