Interface Specification - இடைமுக விவரக்குறிப்பு
AADHYA Public API Reference
Detailed specification of the publicly exposed diagnostic and authentication endpoints.
Administrative queries into the /soul partition require a signed Bearer JWT token.
| Method | Endpoint | Authentication | Description & Response Notes |
|---|---|---|---|
| GET | /health |
Public / None | System diagnostic heartbeat. Returns service status, node version, and ORM build metrics. |
| POST | /api/login |
Public / None | Authenticates an operator with username & password. Issues an RS256 JWT on credential validation. |
| GET | /api/me |
Bearer JWT | Resolves the caller's session context and associated permissions level. |
| GET | /soul |
Client Web UI | Visual Soul Gateway web interface. Automatically relays cached session tokens. |
| GET | /api/soul |
Admin Bearer JWT | Decodes AADHYA's fundamental soul matrix and returns decrypted system flag. Admin role required. |
Payload Schemas
Authentication Workflow
HTTP REQUEST / RESPONSE PROTOCOL
JSON RPC
# 1. Requesting access token
curl -X POST http://aadhya.local/api/login \
-H "Content-Type: application/json" \
-d '{"username": "aadhya_admin", "password": "<credential>"}'
# 2. Token payload response
{
"token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...",
"message": "Consciousness unlocked - அணுகல் அனுமதிக்கப்பட்டது"
}
"token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...",
"message": "Consciousness unlocked - அணுகல் அனுமதிக்கப்பட்டது"
}
# 3. Invoking the Soul Consciousness
curl -H "Authorization: Bearer <TOKEN>" http://aadhya.local/api/soul
Security & Access Notice
All requests are monitored and logged by the Chennai Neural Institute Security Matrix. Rate limiting is enforced per origin. Any unauthorized attempt to inject operator parameters will be logged.