API Reference

The planned backend API should separate deterministic metadata retrieval from optional semantic processing.

Planned Endpoints

• GET /api/health
• POST /api/crawls
• GET /api/crawls
• GET /api/crawls/{id}
• GET /api/machines
• POST /api/machines/register
• GET /api/search
• POST /api/search/semantic

Design Rules

• keep crawl execution asynchronous
• paginate list and search responses
• use metadata retrieval before LLM refinement
• keep semantic search optional