Getting Started
DISNOMIA is a hosted SaaS engine: eCondor Digital runs the central instance of the engine. You don’t download or install anything — you connect with an API key.
1. Get your API key
Contact eCondor Digital to get a key (see Pricing). You’ll receive a key with your plan’s prefix:
| Plan | Prefix |
|---|---|
| Trial | pi_tri_ |
| Starter / Pro | pi_com_ |
2. Configure your backend
ENGINE_HTTP_URL=https://api.disnomia.econdor.comENGINE_API_KEY=pi_com_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx3. Evaluate your first exercise
curl -X POST https://api.disnomia.econdor.com/api/v1/exercises/evaluate \ -H "x-api-key: pi_com_your_api_key" \ -H "Content-Type: application/json" \ -d '{ "exerciseId": "ex_001", "area": "listening", "type": "multiple_choice", "answer": "B", "correctAnswer": "B", "difficulty": 2 }'Response:
{ "correct": true, "score": 10, "feedback": "Correct!", "metadata": { "area": "listening", "type": "multiple_choice" }}Next steps
- Quickstart — your first call in 5 minutes
- Authentication — key format and how to send it
- Rate Limits — limits per plan
- API - Evaluate — full documentation of the evaluation endpoint
- Exercises - Overview — the 8 supported exercise types
- NestJS Integration · Express Integration