{"pageKey":"Developers","slug":"developers-api-integrations","locale":"fr","localeResolved":"fr","fallbackApplied":false,"version":"developers-api-integrations@2026-07-21T09:39:17.914Z","lastModified":"2026-07-21T09:39:17.914Z","canonicalUrl":"https://www.merchandaise.com/fr/developers/api-integrations","payload":{"slug":"developers-api-integrations","purpose":"llm-developers-api-integrations","title":"API Merchandise et contrats d'intégration | MerchandAise","description":"Consultez les contrats MerchandAise pour les outils d'assistant, les intégrations communautaires, les opérations fournisseurs et l'identité entreprise, avec des limites d'accès publiques et protégées clairement définies.","sections":[{"heading":"Conserver une source unique de vérité","paragraphs":["Une intégration doit étendre le flux MerchandAise, pas le dupliquer. Les surfaces site, embed, fournisseur, entreprise et futures surfaces d'assistant doivent lire et mettre à jour le même design versionné, l'intention commerciale, le devis, l'approbation et l'état de la commande.","Lorsque MerchandAise gère la transaction acheteur, Hutter Products GmbH est le vendeur contractuel et Merchant of Record sous la marque MerchandAise. L'identité et les coordonnées des fournisseurs restent privées sauf obligation de divulgation, et la production exige toujours l'approbation de l'épreuve numérique et d'un échantillon réel."]},{"heading":"Surfaces API et d'intégration","items":[{"title":"Docs API — outils assistant","description":"Consultez les endpoints actuels pour assistants et outils destinés aux sessions de design et à la revue d'intégration. Cette référence publique n'accorde pas l'autorité anonyme pour établir un devis ou passer une commande. Human guide: Ouvrir les docs outils assistant (/fr/developers/api-integrations). Machine-readable contract: OpenAPI JSON — outils assistant (/api/docs/openapi.json). Access: public. Référence publique pour les API d'assistant et d'outillage. L'accès en production et les opérations modifiant les commandes nécessitent toujours l'autorisation appropriée. Canonical page: /developers/api-integrations. Canonical section: /developers/api-integrations#api-docs."},{"title":"API d'intégration communautaire","description":"Connectez des expériences localisées de club, communauté ou vitrine aux handoffs de design et de commerce détenus par MerchandAise sans reconstruire le workflow sous-jacent. Human guide: Consulter le guide d'intégration communautaire (/fr/developers/api-integrations#community-integrations). Machine-readable contract: OpenAPI JSON — communauté (/api/v1/community/public/openapi/v1). Access: public. Contrat versionné public pour les embeds de vitrine, la découverte communautaire et les handoffs adaptés à la locale. Canonical page: /developers/api-integrations. Canonical section: /developers/api-integrations#community-integrations."},{"title":"API fournisseur","description":"Connectez des fournisseurs approuvés aux opérations d'onboarding, catalogue, devis et exécution une fois la relation fournisseur et le modèle d'accès qualifiés. Human guide: Consulter le guide d'intégration fournisseur (/fr/developers/api-integrations#supplier-integrations). Machine-readable contract: OpenAPI JSON — fournisseur (/api/v1/supplier/openapi/v1). Access: public. Contrat public pour planification et génération de clients. L'accès opérationnel fournisseur reste soumis à autorisation. Canonical page: /developers/api-integrations. Canonical section: /developers/api-integrations#supplier-integrations."},{"title":"API d'identité entreprise","description":"Planifiez SSO, provisionnement SCIM et flux d'identité audités pour des programmes d'équipe approuvés et des déploiements encadrés. Human guide: Consulter le guide d'intégration entreprise (/fr/developers/api-integrations#enterprise-integrations). Machine-readable contract: OpenAPI JSON — identité entreprise (/api/v1/enterprise/identity/openapi/v1). Access: protected. Contrat protégé pour espaces de travail entreprise approuvés ; demandez l'accès avant d'utiliser ce endpoint. Canonical page: /developers/api-integrations. Canonical section: /developers/api-integrations#enterprise-integrations."}]},{"heading":"Choisissez le contrat avant le code","items":[{"title":"Step 1: Cartographiez le parcours utilisateur","description":"Décidez qui entre dans le flux et où : un acheteur dans une vitrine intégrée, un fournisseur approuvé, un utilisateur entreprise, ou un assistant opérant avec une autorisation explicite."},{"title":"Step 2: Confirmez la limite d'accès","description":"Utilisez les contrats publics pour l'évaluation et la génération de clients, puis confirmez identifiants, scopes, environnements, callbacks et endpoints protégés avant l'implémentation."},{"title":"Step 3: Démontrez la continuité d'état","description":"Testez que les designs, devis, approbations, erreurs et handoffs de commande restent à jour à travers l'intégration, y compris les chemins de retry et de rollback."}]},{"heading":"Ce que chaque intégration doit préserver","items":[{"title":"Un état versionné unique","description":"Design, intention commerciale, devis adossé au fournisseur, approbation et statut de commande demeurent connectés. Les modifications obsolètes doivent déclencher un re-devis visible ou un état de révision."},{"title":"Confidentialité commerciale et fournisseur","description":"MerchandAise reste l'interlocuteur commercial et le support côté acheteur. Les identités, contacts et données internes des fournisseurs ne sont pas exposés via les intégrations publiques."},{"title":"Approbation avant production","description":"Une vue produit-native 3D et une épreuve numérique soutiennent la décision, mais ne remplacent pas l'échantillon réel requis avant la production de masse."}]},{"heading":"Avant la mise en production","paragraphs":["Un fichier OpenAPI publié est une surface de planification, pas une promesse d'accès en production anonyme. Nous examinons environnements, identifiants, gestion des erreurs et responsabilité opérationnelle avant la mise en service."],"items":[{"title":"Accès et environnements","description":"Confirmez la version du contrat, l'espace de travail approuvé, les scopes d'authentification, sandbox, identifiants de production et destinations de callback."},{"title":"Pannes et récupération","description":"Définissez retries, idempotence, timeouts, erreurs visibles client, observabilité, responsabilité du support et rollback avant la mise en production."},{"title":"Preuve de bout en bout","description":"Vérifiez le parcours prévu en staging depuis l'entrée et la mutation d'état jusqu'au devis, l'approbation, le handoff et le comportement de récupération."}]},{"heading":"FAQ","items":[{"title":"Par quelle surface d'intégration dois-je commencer ?","description":"Commencez par la personne et la transition d'état. Utilisez les embeds communautaires pour les parcours acheteurs orientés club ou communauté, les opérations fournisseur pour les workflows côté supply approuvés, l'identité entreprise pour SSO et SCIM, et les outils d'assistant uniquement pour des flux AI explicitement autorisés."},{"title":"Un contrat public signifie-t-il accès en production public ?","description":"Non. Un contrat OpenAPI public sert à la découverte, la revue d'architecture et la génération de clients. Les identifiants de production, les opérations d'écriture, les workflows fournisseur, l'identité entreprise et l'exécution d'assistant peuvent toujours nécessiter un espace de travail approuvé et une autorisation ciblée."},{"title":"Une intégration peut-elle exposer des fournisseurs ou contourner des approbations ?","description":"Non. L'identité et les coordonnées des fournisseurs restent privées sauf obligation de divulgation, MerchandAise conserve la relation acheteur, et les actions affectant les commandes doivent préserver les étapes d'approbation configurées et la validation par échantillon réel."}]},{"heading":"Apportez-nous le flux, pas une architecture définitive.","paragraphs":["Dites-nous qui utilisera l'intégration, quels états doivent être lus ou modifiés et où l'expérience se déploiera. Nous cartographierons avec vous le contrat, le modèle d'accès et le chemin de déploiement le plus sûr."],"items":[{"title":"Planifier une intégration","description":"/fr/contact?intent=api-integration-review"},{"title":"Explorer les agents AI et MCP","description":"/fr/developers/ai-agents-mcp"}]}],"source":{"type":"page-copy","id":"Developers"}},"metadata":{"source":"page-content","schema":"2025-11-05"}}