Documentation API

Intégrez l'analyse cutanée IA de DermaScan dans vos applications avec notre API REST.

Authentification

Toutes les requêtes API nécessitent une clé API dans le header X-DermaScan-Key.

curl -H "X-DermaScan-Key: ds_live_your_api_key" \
  https://dermascan.ma/api/v1/brand/config

Endpoints

GET/api/v1/brand/config

Récupère la configuration de votre marque (couleurs, logo, paramètres du widget).

// Response
{
  "brand": {
    "name": "Ma Marque",
    "primaryColor": "#E8845A",
    "secondaryColor": "#2D8A5E"
  },
  "widget": {
    "buttonText": { "fr": "Analyser ma peau" },
    "buttonPosition": "bottom-right"
  }
}

POST/api/v1/diagnostic

Crée un nouveau diagnostic cutané. Envoyez une photo de visage et recevez l'analyse IA complète.

// Request (multipart/form-data)
curl -X POST \
  -H "X-DermaScan-Key: ds_live_..." \
  -F "file=@photo.jpg" \
  -F 'meta={"locale":"fr","source":"api"}' \
  https://dermascan.ma/api/v1/diagnostic

// Response
{
  "id": "clxyz...",
  "publicId": "8ee2e8f8-...",
  "status": "COMPLETED",
  "globalScore": 61
}

GET/api/v1/diagnostic/:id

Récupère les résultats complets d'un diagnostic (scores, routines, recommandations produits).

GET/api/v1/report/:publicId

Récupère les données d'un rapport public (pas d'authentification requise).

Structure du Diagnostic

Chaque diagnostic analyse la peau selon 7 critères avec un score de 0 à 100 :

Critère	Description	Score
SKIN_TYPE	Équilibre du type de peau	100 = équilibré
HYDRATION	Niveau d'hydratation	100 = optimal
WRINKLES	Rides et ridules	100 = aucune ride
SPOTS	Taches et pigmentation	100 = uniforme
DARK_CIRCLES	Cernes sous les yeux	100 = aucun cerne
UNDER_EYE_BAGS	Poches sous les yeux	100 = aucune poche
ACNE	Acné et imperfections	100 = peau nette

Limites

Limite	Valeur
Requêtes par minute (par IP)	10
Taille max de l'image	10 Mo
Formats acceptés	JPEG, PNG, WebP
Quota mensuel	Selon votre forfait

Prêt à intégrer ?

Créez un compte et générez votre clé API pour commencer.

Créer un compte Nous contacter