Documentación de la API

Crea aplicaciones de salud sobre la API de ClapDiet: una interfaz REST para el análisis de laboratorio, los datos de alimentos y las recomendaciones nutricionales personalizadas.

Primeros pasos

1. Solicita acceso

La API de ClapDiet está en acceso limitado y todavía no es de autoservicio: no hay ninguna clave que generar en los ajustes de tu cuenta. Escríbenos y prepararemos tus credenciales.

2. Autentica tu solicitud

Envía tu token en la cabecera Authorization de cada solicitud. Por ejemplo:

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

3. Procesa la respuesta

Todas las respuestas son JSON. Revisa el código de estado: 200 indica éxito, mientras que los códigos 400 y 500 indican que algo falló.

Autenticación

La API de ClapDiet se autentica con tokens Bearer. Incluye el tuyo en la cabecera Authorization de cada solicitud.

Importante: Nunca compartas tu token ni lo pongas en código del lado del cliente donde otros puedan leerlo. Mantenlo en tu servidor.

Endpoints

POST/api/v1/auth/registerCrear una cuenta de usuario

POST/api/v1/auth/loginIniciar sesión y recibir tokens de acceso

GET/api/v1/labsListar los resultados de laboratorio de un usuario

POST/api/v1/labs/uploadSubir nuevos resultados de laboratorio (PDF o imagen)

GET/api/v1/foodsBuscar en la base de datos de alimentos

GET/api/v1/recommendationsObtener recomendaciones de alimentos personalizadas

Límites de uso

Para que la API siga siendo rápida y justa para todos, las solicitudes se limitan en tres ventanas solapadas. Las tres se aplican a la vez.

por segundo

cada 10 segundos

100

por minuto

Estos son los valores por defecto del servicio; un operador puede reducirlos.

¿Necesitas ayuda?

Nuestro equipo está aquí para ayudarte a construir con la API.

Contactar con soporte