Documentación API & Agentes Autónomos
GuaranIA expone contratos fuertemente tipados y puntos de integración programáticos listos para ser consumidos tanto por sistemas de software como por agentes autónomos de inteligencia artificial (Claude, ChatGPT, Gemini, LangChain, LlamaIndex).
OpenAPI JSON
Esquema completo y formal con rutas, modelos de datos, validaciones y códigos de estado HTTP.
Manifiesto MCP
Model Context Protocol para interoperabilidad directa con clientes Anthropic Claude, Cursor y Antigravity.
Archivo llms.txt
Directrices semánticas de ruteo, contexto operacional y políticas de citación para crawlers y modelos generativos.
Sitemap XML
Estructura jerárquica de todas las rutas de servicio, landing pages y recursos estáticos de GuaranIA.
02 — CATÁLOGO DE ENDPOINTS
Puntos de enlace REST v1
| MÉTODO | ENDPOINT | ACCESO | DESCRIPCIÓN |
|---|---|---|---|
| GET | /api/v1/organization | Público (Libre) | Metadatos institucionales, razón social, ubicación física y datos fiscales en Paraguay. |
| GET | /api/v1/services | Público (Libre) | Catálogo estructurado de soluciones en Inteligencia Artificial, RPA y desarrollo web. |
| POST | /api/v1/contact | 60 req / min | Hand-off comercial y técnico para registrar consultas de proyectos empresariales. |
| POST | /api/v1/assessment | 60 req / min | Evaluación algorítmica de viabilidad de automatización y estimación de retorno de inversión. |
| GET | /openapi.json | Público (Libre) | Contrato OpenAPI 3.1.0 completo para autogeneración de clientes SDK. |
| GET | /.well-known/mcp/manifest.json | Público (Libre) | Definición de esquemas y herramientas bajo el estándar Model Context Protocol. |
03 — EJEMPLOS DE INTEGRACIÓN
Terminal de integración rápida
curl -X GET "https://guarania.com.py/api/v1/organization" \
-H "Accept: application/json"curl -X POST "https://guarania.com.py/api/v1/contact" \
-H "Content-Type: application/json" \
-d '{
"name": "Distribuidora Guaraní",
"email": "[email protected]",
"phone": "+595 981 123456",
"company": "Distribuidora Guaraní S.A.",
"message": "Solicitud de evaluación para automatización de facturación SET/DNIT."
}'Estándares de Interoperabilidad Autónoma
Cero Fricción en Consultas
Los endpoints de lectura de servicios, metadata empresarial y especificaciones OpenAPI están abiertos sin autenticación ni registro obligatorio.
Rate Limiting Generoso
Cuota base de 60 solicitudes por minuto por dirección IP, permitiendo sincronización programática y re-indexación continua sin bloqueos prematuros.
Formatos Duales Humano/IA
Cada vista del sitio cuenta con su contraparte semántica en JSON o Markdown plano para agentes autónomos y crawlers de búsqueda generativa.