Astryx Documents API: Production-Ready Document Ingestion & Vector Backend with Xano
Source: Dev.to
Overview
Astryx Documents API is a production‑ready backend built with Xano, designed to ingest aeronautics documents, structure them, split them into semantic chunks, and store vector embeddings for AI‑powered search and retrieval. It targets real‑world use cases such as technical documentation analysis, maintenance manuals, and knowledge retrieval systems. The API is secured with token‑based authentication and organized for scalability and maintainability.
Endpoints
| Method | Endpoint | Description |
|---|---|---|
POST | /documents | Adds a document record with metadata. |
POST | /add_document_with_vectors | Ingests a document, splits its content into chunks, and stores vector embeddings linked to each chunk. |
All endpoints require a Bearer token for authentication and belong to a private API group, making the API ready for controlled public or partner access.
Demo
- Video & screenshots: Google Drive folder
- Source code: (link not provided)
The demo showcases:
- API execution in Xano
- Document insertion
- Automatic chunk creation
- Vector storage in the database
Development Process
- Used AI to generate an initial backend structure and XanoScript endpoints for document ingestion and storage.
- Prompt goal: accelerate backend creation, then manually refine to meet production standards.
Refinements Made
- Fixed invalid XanoScript syntax that did not compile.
- Refactored endpoints to respect Xano’s execution model.
- Removed unsupported control structures.
- Added secure authentication requirements.
- Designed a clear document → chunk → vector data pipeline.
- Improved maintainability and clarity of the API logic.
This process highlighted the essential role of human expertise in transforming AI‑generated code into reliable production systems.
Challenges & Learnings
- Challenge: Mastering strict XanoScript syntax.
- Solution: Once understood, it enabled clean, scalable backend logic with excellent performance and security.
Xano proved to be a powerful platform for building real‑world APIs enhanced by AI workflows, allowing rapid movement from idea to production‑ready backend without managing infrastructure.