Démarrer

Qu'est-ce que FRED ?

FRED est une plateforme de fulfillment 3D : vous vendez des objets imprimés en 3D (boutique Etsy/Shopify, marque, application), FRED fabrique chaque commande dans une ferme d'impression et l'expédie au nom de votre marque, avec suivi. Vous ne touchez ni imprimante, ni carton.

Le parcours type côté API :

1. Uploader un fichier (POST /v1/files) — STL validé géométriquement.
2. Obtenir un devis (POST /v1/quotes) — prix de production instantané.
3. Créer la commande (POST /v1/orders) — elle part en fabrication, vous recevez les événements webhook jusqu'à la livraison.

Créer un compte et une clé API

1. Créez votre compte sur app.fredpod.com/register.
2. Dans Développeurs → Clés API, créez une clé : elle commence par sk_ et n'est affichée qu'une seule fois — copiez-la immédiatement.
3. Passez-la sur chaque requête dans l'en-tête X-API-Key.

Premier appel

Uploadez un STL :

curl -X POST https://api.fredpod.com/v1/files \
  -H "X-API-Key: sk_votre_cle" \
  -F "file=@porte-cles.stl"

La réponse contient l'id du fichier (file_…) et son statut de validation. Demandez un devis :

curl -X POST https://api.fredpod.com/v1/quotes \
  -H "X-API-Key: sk_votre_cle" \
  -H "Content-Type: application/json" \
  -d '{
    "file_id": "file_abc123",
    "color": "black",
    "quantity": 2,
    "country": "FR"
  }'

Le devis (quote_…) donne le prix de production en centimes et une estimation grammes/minutes. Il est valable 24 h. Créez la commande :

curl -X POST https://api.fredpod.com/v1/orders \
  -H "X-API-Key: sk_votre_cle" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: commande-42" \
  -d '{
    "items": [{ "quote_id": "quote_def456" }],
    "external_ref": "ETSY-1042",
    "confirm": true,
    "shipping_address": {
      "name": "Camille Dupont",
      "line1": "10 rue de la Paix",
      "postal_code": "75002",
      "city": "Paris",
      "country": "FR"
    }
  }'

Avec "confirm": true la commande part immédiatement en fabrication ; sans, elle reste en brouillon jusqu'à POST /v1/orders/{id}/confirm.

Et ensuite ?

• Authentification — clés, sessions, révocation.
• Commandes — cycle de vie complet et idempotence.
• Marques & white-label — votre nom sur les colis.
• Webhooks — être notifié de chaque étape.
• Fabricant — rejoindre le réseau avec vos imprimantes.
• La référence API complète est générée depuis la spécification OpenAPI de l'API — chaque endpoint, chaque champ, dans la barre latérale.