API de Almendra para desarrolladores

La API de Almendra es una API REST para el software que nutricionistas, dietistas, coaches y entrenadores personales usan cada día. Conecta una cuenta de Almendra con tu propio sistema, con Zapier o con un agente de IA: lee y actualiza pacientes, citas, planes alimenticios, alimentos, recetas y datos clínicos.

En resumen

• URL base: https://api.almendra.io/openapi/v1
• Especificación: OpenAPI 3.1
• Referencia: referencia de la API, con cada operación, el permiso que necesita y ejemplos.
• Autenticación: una clave de API en Authorization: Bearer <clave>. Cada clave pertenece a una cuenta profesional y tiene sus propios permisos.
• Límite: 600 solicitudes por minuto por clave, con las cabeceras RateLimit y RateLimit-Policy; un 429 trae Retry-After.
• Errores: JSON con un error.code estable en cada respuesta 4xx y 5xx.
• Versiones: dentro de v1 solo hay cambios compatibles. Los cambios incompatibles salen como /openapi/v2, con las cabeceras Deprecation y Sunset al menos 6 meses antes.

Consigue una clave de API

1. Crea una cuenta de Almendra: es gratis y no pide tarjeta.
2. La API está incluida en los planes de pago: elige uno en Precios.
3. En Almendra, ve a Configuración › Desarrolladores › Claves API, haz clic en Crear clave API, elige sus permisos y cópiala (solo se muestra una vez).

Guía paso a paso: Cómo conectar Almendra con otras herramientas.

Primera solicitud

curl https://api.almendra.io/openapi/v1/patients \
  -H "Authorization: Bearer $ALMENDRA_API_KEY"

Qué puedes hacer

• Pacientes: listar, crear, leer y editar (patients:read, patients:write).
• Citas: listar, agendar, reagendar y eliminar (appointments:read, appointments:write).
• Planes de servicio: listar los planes y el plan activo de un paciente (health_plans:read).
• Planes alimenticios: listar, crear, editar y enviar al paciente (meal_plans:read, meal_plans:write).
• Alimentos, recetas y grupos de intercambio: buscar, crear y editar (library:read, library:write).
• Datos clínicos: historia clínica, consultas con notas y mediciones, y fotos de progreso (clinical:read).

Webhooks

Recibe un aviso cuando se envía un plan alimenticio (meal_plan.sent), se termina una consulta (consultation.completed) o un paciente completa su formulario (form.completed). Registra direcciones HTTPS en Configuración › Desarrolladores › Webhooks. Los avisos solo llevan ids y van firmados con HMAC-SHA256 en la cabecera Almendra-Signature.

Servidor MCP para asistentes de IA

ChatGPT, Claude y otros clientes MCP se conectan a https://api.almendra.io/mcp con OAuth, sin clave de API. Más información en Servidor MCP de Almendra.

Recursos para máquinas

• Especificación OpenAPI 3.1
• Índice del sitio para agentes de IA (llms.txt)
• Soporte técnico: soporte@almendra.io