Documentation de l’API

Créez des applications de santé sur l’API ClapDiet : une interface REST pour l’analyse des bilans, les données alimentaires et les recommandations nutritionnelles personnalisées.

Démarrage rapide

1. Demandez un accès

L’API ClapDiet est en accès limité et n’est pas encore en libre-service : aucune clé n’est à générer dans les paramètres de votre compte. Écrivez-nous et nous préparerons vos identifiants.

2. Authentifiez votre requête

Envoyez votre jeton dans l’en-tête Authorization de chaque requête. Par exemple :

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

3. Traitez la réponse

Toutes les réponses sont en JSON. Vérifiez le code de statut : 200 signifie succès, tandis que les codes 400 et 500 signalent une erreur.

Authentification

L’API ClapDiet s’authentifie avec des jetons Bearer. Incluez le vôtre dans l’en-tête Authorization de chaque requête.

Important: Ne partagez jamais votre jeton et ne le placez pas dans du code côté client où d’autres pourraient le lire. Gardez-le sur votre serveur.

Points de terminaison

POST/api/v1/auth/registerCréer un compte utilisateur

POST/api/v1/auth/loginSe connecter et recevoir des jetons d’accès

GET/api/v1/labsLister les analyses d’un utilisateur

POST/api/v1/labs/uploadTéléverser de nouvelles analyses (PDF ou image)

GET/api/v1/foodsRechercher dans la base d’aliments

GET/api/v1/recommendationsObtenir des recommandations alimentaires personnalisées

Limites de débit

Pour garder l’API rapide et équitable pour tous, les requêtes sont plafonnées sur trois fenêtres qui se chevauchent. Les trois s’appliquent simultanément.

par seconde

par 10 secondes

100

par minute

Ce sont les valeurs par défaut du service ; un opérateur peut les abaisser.

Besoin d’aide ?

Notre équipe est là pour vous aider à construire avec l’API.

Contacter le support