DropFragranceAPI Documentation
Plans & TarifsDashboard

Documentation API Dropfragrance

Intégrez notre catalogue de 30 000+ produits directement dans votre boutique e-commerce

⚠️ Accès API réservé aux plans PRO et BOUTIQUE

🔑 Authentification

Toutes les requêtes API nécessitent une clé d'authentification dans le header X-API-Key

curl -H "X-API-Key: df_votre_cle_api_ici" \
  https://www.dropfragrance.com/api/v1/products

📍 Récupérez votre clé API dans votre dashboard

Endpoints disponibles

GET/api/v1/products

Récupère la liste des produits du catalogue avec pagination et filtres

Paramètres de requête

page (optionnel) - Numéro de page (défaut: 1)
limit (optionnel) - Produits par page (défaut: 50, max: 200)
country (optionnel) - Code pays pour les prix (FR, BE, etc.)
brand (optionnel) - Filtrer par marque
category (optionnel) - Filtrer par catégorie
in_stock (optionnel) - true pour uniquement produits en stock

Exemple de requête

curl -H "X-API-Key: df_your_api_key" \
  "https://www.dropfragrance.com/api/v1/products?page=1&limit=10&country=FR&in_stock=true"

Réponse (200 OK)

{
  "data": [
    {
      "id": 12345,
      "ean13": "3614273070447",
      "name": "Dior Sauvage Eau de Toilette 100ml",
      "brand": "Dior",
      "category": "Eau de Toilette",
      "size": "100ml",
      "type": "Parfum",
      "gender": "Homme",
      "image_url": "https://...",
      "stock": 45,
      "supplier": "prague",
      "carrier": "DPD",
      "prices": {
        "wholesale_ht": 42.50,
        "drop_ttc": 58.90,
        "retail_ttc": 89.00,
        "shipping_ht": 4.99,
        "margin_ht": 30.10,
        "margin_percent": 33.8,
        "currency": "EUR"
      }
    }
  ],
  "meta": {
    "page": 1,
    "limit": 10,
    "total": 30542,
    "total_pages": 3055,
    "country": "FR",
    "generated_at": "2026-10-18T14:30:00Z"
  }
}
POST/api/v1/orders

Créer une nouvelle commande qui sera automatiquement transmise au grossiste

Corps de la requête

{
  "items": [
    {
      "ean13": "3614273070447",
      "quantity": 2
    }
  ],
  "shipping_address": {
    "first_name": "Jean",
    "last_name": "Dupont",
    "address1": "123 Rue de la Paix",
    "city": "Paris",
    "postal_code": "75001",
    "country_code": "FR",
    "phone": "+33612345678",
    "email": "client@example.com"
  },
  "reseller_order_id": "ORDER-2026-001"
}

Exemple de requête

curl -X POST \
  -H "X-API-Key: df_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{"items":[...], "shipping_address":{...}}' \
  https://www.dropfragrance.com/api/v1/orders

Réponse (201 Created)

{
  "order_id": "ord_abc123xyz",
  "status": "pending",
  "reseller_order_id": "ORDER-2026-001",
  "items": [
    {
      "productId": 12345,
      "productName": "Dior Sauvage Eau de Toilette 100ml",
      "ean13": "3614273070447",
      "quantity": 2,
      "priceWholesale": 42.50,
      "priceDrop": 58.90,
      "supplier": "prague"
    }
  ],
  "total_ttc": 117.80,
  "created_at": "2026-10-18T14:30:00Z"
}

Codes d'erreur

401

Unauthorized

Clé API manquante ou invalide

403

Forbidden

Plan FREE détecté - Upgrade vers PRO ou BOUTIQUE requis

404

Not Found

Ressource introuvable (produit, commande, etc.)

500

Internal Server Error

Erreur serveur - Contactez le support

Limites d'utilisation

  • ✅ Plan PRO : 1000 requêtes / heure
  • ✅ Plan BOUTIQUE : Illimité
  • 📊 Les limites sont par clé API
  • ⏱️ En cas de dépassement, vous recevrez une erreur 429 Too Many Requests

Besoin d'aide ?

Notre équipe est là pour vous accompagner dans l'intégration de l'API

Contacter le supportVoir les plans