Authentifier votre serveur avec une clé API FRED
Relier votre serveur au compte FRED de votre boutique.
Publié par FRED
Préparer le compte
Dans le dashboard FRED, ouvrez Développeurs → Clés API et créez une clé pour votre intégration. Copiez le secret affiché une seule fois, puis stockez-le dans les variables d’environnement de votre serveur.
Votre site appelle votre serveur ; votre serveur appelle FRED avec X-API-Key.
La clé ne doit pas être incluse dans le JavaScript du navigateur ni dans une URL.
curl https://api.fredpod.com/v1/storefront/quotes/est_abc123 \
-H "X-API-Key: $FRED_API_KEY"Permissions nécessaires
| Fonction | Permissions de la clé |
|---|---|
| Envoyer un fichier et demander son prix | files:write, quotes:write |
| Demander un prix pour un produit enregistré | quotes:write |
| Lire un devis | quotes:read |
| Recalculer le transport | quotes:write |
| Créer et suivre les commandes | orders:write, orders:read |
| Lire l’aperçu et approuver un modèle si nécessaire | files:read, files:write |
| Configurer les webhooks par API | webhooks:manage |
Une clé accède uniquement aux ressources de son compte. Si vous utilisez plusieurs
marques, envoyez X-Brand-Id sur vos appels pour conserver le contexte de la boutique.
Les variantes et produits se préparent dans le dashboard ; leur utilisation pour
un devis ne nécessite pas une permission de modification des produits.
Consultez le guide sandbox pour créer l’environnement de test de votre boutique et piloter les simulations.
Test, paiement et mise en service
Une clé de test isole les données et ne provoque pas de paiement réel. Les webhooks
de test peuvent néanmoins être envoyés à l’URL que vous configurez.
Un résultat marqué simulated ne constitue pas un engagement de fabrication réel.
Pour commander en production, configurez votre marque, votre moyen de paiement et
les plafonds d’autorisation automatique dans le dashboard. Le champ
ordering_enabled du devis indique si les commandes sont ouvertes.
Révoquez ou remplacez une clé depuis le dashboard. Une clé expirée ou révoquée reçoit
401, une permission manquante 403.
Erreurs et répétitions
Les erreurs sont des objets application/problem+json. Utilisez code pour votre
logique et conservez request_id pour une demande de support.
{
"status": 409,
"code": "price_limit_exceeded",
"title": "Prix supérieur au plafond",
"detail": "Le total livré dépasse max_total_cents. Aucun débit ni commande n’a été créé.",
"request_id": "req_abc123"
}Les créations de devis et de commandes demandent Idempotency-Key (160 caractères
maximum pour les appels boutique). Réutilisez la même clé et le même contenu après
une erreur réseau. Une même clé avec un contenu différent est refusée avec 422.