Documentação da API

Crie aplicativos de saúde sobre a API do ClapDiet — uma interface REST para análise de exames, dados de alimentos e recomendações nutricionais personalizadas.

Primeiros passos

1. Solicite acesso

A API do ClapDiet está em acesso limitado e ainda não é self-service: não há chave para gerar nas configurações da sua conta. Escreva para nós e prepararemos suas credenciais.

2. Autentique sua requisição

Envie seu token no cabeçalho Authorization de cada requisição. Por exemplo:

curl -X GET https://api.clapdiet.com/api/v1/foods \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json"

3. Trate a resposta

Todas as respostas são JSON. Verifique o código de status: 200 indica sucesso, enquanto códigos 400 e 500 indicam que algo deu errado.

Autenticação

A API do ClapDiet autentica com tokens Bearer. Inclua o seu no cabeçalho Authorization de cada requisição.

Importante: Nunca compartilhe seu token nem o coloque em código do lado do cliente, onde outras pessoas possam lê-lo. Mantenha-o no seu servidor.

Endpoints

POST/api/v1/auth/registerCriar uma conta de usuário

POST/api/v1/auth/loginEntrar e receber tokens de acesso

GET/api/v1/labsListar os exames de um usuário

POST/api/v1/labs/uploadEnviar novos exames (PDF ou imagem)

GET/api/v1/foodsBuscar na base de alimentos

GET/api/v1/recommendationsObter recomendações de alimentos personalizadas

Limites de uso

Para manter a API rápida e justa para todos, as requisições são limitadas em três janelas sobrepostas. As três valem ao mesmo tempo.

por segundo

a cada 10 segundos

100

por minuto

Estes são os padrões com que o serviço é distribuído; um operador pode reduzi-los.

Precisa de ajuda?

Nossa equipe está aqui para ajudar você a construir com a API.

Falar com o suporte