Intégrer l’API d’impression 3D à votre boutique
Devis, commande et suivi pour votre boutique, configurateur ou application.
Publié par FRED · Mis à jour le
FRED fabrique et expédie les objets vendus sur votre site. Votre application fournit le modèle 3D ou l’identifiant d’un produit enregistré ; FRED propose des fabricants, chiffre la livraison et suit la commande jusqu’au client.
MCP
Connectez Claude Code, Codex ou Cursor à FRED : configuration à copier-coller, connexion à votre compte et exemples pour intégrer l’API à votre projet.
Deux opérations structurent l’intégration : obtenir un devis, puis commander. Les appels partent de votre serveur avec la clé créée dans le dashboard.
Les exemples JavaScript s’exécutent sur un serveur Node.js 22+. Pour Python, installez requests avec pip install requests. Remplacez les identifiants d’exemple par ceux renvoyés par vos appels API.
1. Envoyer un objet et obtenir son prix
curl https://api.fredpod.com/v1/storefront/quotes/upload \
-H "X-API-Key: $FRED_API_KEY" \
-H "Idempotency-Key: devis-panier-1042-v1" \
-F "file=@figurine.3mf" \
-F "country=FR" \
-F "postal_code=34000"STL, OBJ et 3MF sont acceptés. Par défaut : une pièce, PLA, taille originale et
couleurs du fichier quand elles sont prises en charge (color=auto). Le pays vaut
FR s’il est omis. Le code postal est facultatif pour comparer la fabrication ;
il devient nécessaire pour un total livré.
La réponse contient id, status, options et recommended_option_id.
Chaque option donne un fabricant, son prix de fabrication, les frais FRED, le
transport et les délais. Les montants sont en centimes d’euro. Les valeurs des exemples de la référence sont illustratives ; seul votre devis donne le prix réel.
Un nouveau fichier peut répondre 202, avec status: "processing" et aucune
option de prix. Le visuel peut être disponible pendant le calcul ; le prix attend
un tranchage réussi. Lisez poll_url toutes les deux secondes pour obtenir les
options confirmées (estimate_source: "slicer"). Une analyse réutilisable peut donner
son résultat immédiatement. Cet appel ne crée aucune commande.
curl https://api.fredpod.com/v1/storefront/quotes/est_abc123 \
-H "X-API-Key: $FRED_API_KEY"Affichez options[].price.total_cents uniquement lorsqu’il est renseigné.
Un transport inconnu vaut null, jamais « gratuit ». Pour une boutique qui choisit
le fabricant automatiquement, utilisez l’option recommandée. Vous pouvez aussi
présenter les alternatives à votre acheteur.
2. Passer la commande
Quand le devis est prêt et l’acheteur a accepté le prix :
curl https://api.fredpod.com/v1/storefront/orders \
-H "X-API-Key: $FRED_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: commande-boutique-1042" \
-d '{
"quote_id": "est_abc123",
"external_ref": "BOUTIQUE-1042",
"shipping_address": {
"name": "Camille Dupont",
"line1": "10 rue de la Paix",
"postal_code": "34000",
"city": "Montpellier",
"country": "FR"
}
}'Sans option_id, FRED choisit la meilleure option disponible. Pour conserver un
choix affiché à l’acheteur, transmettez son option_id. Le pays et le code postal
doivent correspondre au devis ; sinon, recalculez la livraison.
Sans approval_mode, FRED suit les réglages de validation de la marque, ou ceux
du compte en l’absence de marque. auto respecte la pause et l’éventuelle validation
manuelle de la marque. Une réponse 201 signifie que la
commande existe : lisez status et payment_status pour savoir si une action
reste nécessaire. La fabrication démarre seulement après paiement confirmé.
approval_mode: "manual" laisse la commande à vérifier dans le dashboard.
Conservez la même Idempotency-Key et le même corps si une réponse est perdue.
Une nouvelle commande utilise une nouvelle clé.
Adapter à votre site
| Besoin | Guide |
|---|---|
| Afficher prix, fabricants, couleurs et délais | Devis et fabricants |
| Ajouter une carte personnalisée au colis | Inserts de colis |
| Calculer la livraison avant le paiement | Livraison |
| Commander un modèle déjà enregistré | Produits du dashboard |
| Comprendre l’acceptation, le paiement et les reprises | Commandes |
| Mettre à jour votre site et transmettre le suivi | Webhooks et tracking |
La référence ci-dessous est limitée aux appels utiles à une intégration boutique. Les réglages du compte, les imprimantes et l’administration restent dans le dashboard.