Introducción a la API
En Aikount, la API es el producto; la interfaz web es la alternativa para humanos. Todo lo que puedes hacer desde la web —emitir facturas, capturar gastos, conciliar el banco, preparar los modelos de la AEAT— se puede hacer con una llamada HTTP. Cualquier agente o script puede llevar la contabilidad con un token.
Esto no es un añadido: es el diseño. Aikount está pensado para que un agente de IA opere la contabilidad de principio a fin, y para que tú o tu gestor superviséis el resultado. La web existe para las personas que prefieren pulsar botones.
Idea de fondo
- La contabilidad es un conjunto de operaciones repetitivas y verificables: crear una factura, registrar un gasto, enlazar un cobro con su factura, listar el IVA de un trimestre.
- Cada una de esas operaciones es un endpoint. Un agente encadena endpoints igual que una persona encadena clics.
- Con un token válido, el agente actúa dentro de tu empresa (tenant) y respeta las mismas reglas que la web: aislamiento multi-tenant, deduplicación de compras, contabilización en el Plan General Contable.
Base y superficies públicas
La base de la API es:
https://api.aikount.com
Los endpoints de negocio cuelgan de /api/v1 (por ejemplo /api/v1/invoices). Tienes tres formas de explorar la API en detalle:
| Superficie | URL | Para qué |
|---|---|---|
| Swagger UI | https://api.aikount.com/docs | Explorar y probar endpoints desde el navegador |
| OpenAPI JSON | https://api.aikount.com/openapi.json | Especificación legible por máquina (fuente de la verdad) |
| Redoc | https://api.aikount.com/redoc | Referencia navegable, orientada a lectura |
La especificación OpenAPI es la fuente de la verdad sobre parámetros, tipos y respuestas. Si esta documentación y el
openapi.jsondiscrepan, manda elopenapi.json.
Qué leer a continuación
- Para conseguir un token y empezar a llamar: Autenticación y claves de API.
- Para conectar un agente por MCP (Claude Code, Cursor, Gemini CLI, Codex): MCP y Conectar un agente.
- Para el mapa de los endpoints de negocio: Endpoints principales.
- Para las reglas transversales (dinero, fechas, IDs, errores, paginación): Convenciones de la API.