Documentation

Intégrez notre API en quelques minutes

Tout ce dont vous avez besoin pour intégrer l'API 3D Bin Packing dans vos applications. Exemples de code, références et guides.

Démarrage rapide

Créez un compte et obtenez votre clé API

Inscrivez-vous gratuitement et générez une clé API depuis votre dashboard.

Créer un compte

Faites votre première requête

Utilisez votre clé API pour appeler l'endpoint de packing.

curl -X POST https://votre-domaine.com/api/v1/pack \
  -H "Authorization: Bearer sk_votre_cle_api" \
  -H "Content-Type: application/json" \
  -d '{
    "bins": [{"id": "box1", "w": 60, "h": 40, "d": 30, "max_wg": 25}],
    "items": [{"id": "item1", "q": 5, "w": 10, "h": 10, "d": 10, "wg": 0.5}]
  }'

Recevez les résultats optimisés

L'API retourne les positions optimales de chaque item dans les cartons.

{
  "success": true,
  "bins_packed": 1,
  "items_packed": 5,
  "utilization": 0.83,
  "boxes": [...]
}

Référence API

3D Bin Packing

POST /api/v1/pack

Optimisez l'emballage de vos produits dans des cartons. Calculez les positions 3D optimales.

Voir la documentation

Authentification

Clés API & Sécurité

Apprenez à gérer vos clés API, les bonnes pratiques de sécurité et la rotation des clés.

Voir la documentation

Authentification

Toutes les requêtes API doivent inclure votre clé API dans le headerAuthorization.

Authorization: Bearer sk_votre_cle_api

Préfixe des clés

Les clés commencent par sk_ pour les clés secrètes.

Ne jamais exposer

Ne jamais inclure votre clé API dans le code côté client.

Rotation

Vous pouvez régénérer vos clés à tout moment depuis le dashboard.

Quotas & Limites

Plan	Requêtes/mois	Rate limit
Free	100	10 req/min
Starter	5 000	60 req/min
Pro	50 000	300 req/min

Note : Si vous dépassez votre quota mensuel, les requêtes retourneront une erreur 429. Passez au plan supérieur pour plus de requêtes.

Exemples de code

JavaScript / Node.js

const response = await fetch('https://votre-domaine.com/api/v1/pack', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer sk_votre_cle_api',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    bins: [{ id: 'carton1', w: 60, h: 40, d: 30, max_wg: 25 }],
    items: [
      { id: 'produit1', q: 10, w: 15, h: 10, d: 8, wg: 0.3 },
      { id: 'produit2', q: 5, w: 20, h: 15, d: 12, wg: 0.8 },
    ],
    params: { images_complete: 1 }
  }),
});

const result = await response.json();
console.log(result);

Python

import requests

response = requests.post(
    'https://votre-domaine.com/api/v1/pack',
    headers={
        'Authorization': 'Bearer sk_votre_cle_api',
        'Content-Type': 'application/json',
    },
    json={
        'bins': [{'id': 'carton1', 'w': 60, 'h': 40, 'd': 30, 'max_wg': 25}],
        'items': [
            {'id': 'produit1', 'q': 10, 'w': 15, 'h': 10, 'd': 8, 'wg': 0.3},
            {'id': 'produit2', 'q': 5, 'w': 20, 'h': 15, 'd': 12, 'wg': 0.8},
        ],
        'params': {'images_complete': 1}
    }
)

print(response.json())

cURL

curl -X POST https://votre-domaine.com/api/v1/pack \
  -H "Authorization: Bearer sk_votre_cle_api" \
  -H "Content-Type: application/json" \
  -d '{
    "bins": [{"id": "carton1", "w": 60, "h": 40, "d": 30, "max_wg": 25}],
    "items": [
      {"id": "produit1", "q": 10, "w": 15, "h": 10, "d": 8, "wg": 0.3}
    ]
  }'

Prêt à commencer ?

Créez votre compte gratuitement et commencez à utiliser l'API avec 100 requêtes offertes chaque mois.

Créer un compte gratuit Documentation complète