API da Almendra para desenvolvedores

A API da Almendra é uma API REST para o software que nutricionistas, coaches e personal trainers usam todos os dias. Conecte uma conta da Almendra ao seu próprio sistema, ao Zapier ou a um agente de IA: leia e atualize pacientes, consultas, planos alimentares, alimentos, receitas e dados clínicos.

Em resumo

• URL base: https://api.almendra.io/openapi/v1
• Especificação: OpenAPI 3.1
• Referência: referência da API, com cada operação, a permissão necessária e exemplos.
• Autenticação: uma chave de API em Authorization: Bearer <chave>. Cada chave pertence a uma conta profissional e tem suas próprias permissões.
• Limite: 600 requisições por minuto por chave, com os cabeçalhos RateLimit e RateLimit-Policy; um 429 traz Retry-After.
• Erros: JSON com um error.code estável em toda resposta 4xx e 5xx.
• Versões: dentro da v1 só há mudanças compatíveis. Mudanças incompatíveis saem como /openapi/v2, com os cabeçalhos Deprecation e Sunset pelo menos 6 meses antes.

Obtenha uma chave de API

1. Crie uma conta na Almendra: é grátis e não pede cartão.
2. A API está incluída nos planos pagos: escolha um em Preços.
3. Na Almendra, vá em Configurações › Desenvolvedores › Chaves de API, clique em Criar chave de API, escolha as permissões e copie a chave (ela só aparece uma vez).

Guia passo a passo: Como conectar a Almendra com outras ferramentas.

Primeira requisição

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

O que você pode fazer

• Pacientes: listar, criar, ler e editar (patients:read, patients:write).
• Consultas agendadas: listar, agendar, reagendar e excluir (appointments:read, appointments:write).
• Planos de serviço: listar os planos e o plano ativo de um paciente (health_plans:read).
• Planos alimentares: listar, criar, editar e enviar ao paciente (meal_plans:read, meal_plans:write).
• Alimentos, receitas e grupos de substituição: buscar, criar e editar (library:read, library:write).
• Dados clínicos: histórico clínico, consultas com notas e medidas, e fotos de progresso (clinical:read).

Webhooks

Receba um aviso quando um plano alimentar é enviado (meal_plan.sent), uma consulta é finalizada (consultation.completed) ou um paciente preenche o formulário (form.completed). Cadastre endereços HTTPS em Configurações › Desenvolvedores › Webhooks. Os avisos levam apenas ids e são assinados com HMAC-SHA256 no cabeçalho Almendra-Signature.

Servidor MCP para assistentes de IA

ChatGPT, Claude e outros clientes MCP se conectam a https://api.almendra.io/mcp com OAuth, sem chave de API. Saiba mais em Servidor MCP da Almendra.

Recursos para máquinas

• Especificação OpenAPI 3.1
• Índice do site para agentes de IA (llms.txt)
• Suporte técnico: soporte@almendra.io