{"pageKey":"Developers","slug":"developers","locale":"fr-CH","localeResolved":"fr-CH","fallbackApplied":false,"version":"developers@2026-10-10T09:17:55.391Z","lastModified":null,"canonicalUrl":"https://www.merchandaise.com/fr-ch/developers","payload":{"slug":"developers","purpose":"llm-developers","title":"Espace développeurs : API, OpenAPI et MCP | MerchandAise","description":"Intégrez les produits personnalisés avec les API MerchandAise. Découvrez OpenAPI, les communautés intégrées, les parcours fournisseurs, le SSO d’entreprise et MCP.","sections":[{"heading":"Espace développeurs MerchandAise","paragraphs":["Connectez votre site, vos systèmes d’entreprise ou votre assistant IA à MerchandAise. Explorez les API de design, de boutiques communautaires, d’opérations fournisseurs et d’identité d’entreprise, avec des spécifications OpenAPI et une documentation MCP pour guider l’intégration."]},{"heading":"Pour les systèmes qui accompagnent votre programme","items":[{"title":"Responsables de communautés","description":"Intégrez des boutiques, des passages au configurateur et des parcours communautaires aux sites de clubs, ligues et entreprises, avec des contrats publics versionnés."},{"title":"Équipes d’entreprise et partenaires de plateforme","description":"Reliez les portails d’achat, systèmes d’identité et opérations internes aux parcours de produits personnalisés sans reconstruire la logique des validations et fournisseurs."},{"title":"Créateurs d’agents IA et d’automatisations","description":"Donnez aux assistants un accès structuré aux outils de découverte, de devis et d’opérations autorisées via des points d’accès compatibles MCP."}]},{"heading":"Trouvez votre intégration","items":[{"title":"Documentation API et OpenAPI","description":"Consultez la référence API des outils pour assistants et sessions de design, puis choisissez le contrat communauté, fournisseur ou entreprise adapté à votre parcours. Human guide: Découvrir la documentation API (/fr-ch/developers/api-integrations). Machine-readable contract: OpenAPI des outils pour assistants · JSON (/api/docs/openapi.json). Access: public. Référence publique des API pour assistants et outils. L’accès en production et les opérations qui affectent une commande nécessitent toujours les autorisations applicables. Canonical section: /fr-ch/developers#api-docs."},{"title":"API communautés","description":"Connectez le site d’un club ou d’une communauté aux informations publiques, propositions de design, votes et passages vers la validation des commandes. Human guide: Découvrir l’API communautés (/fr-ch/developers/api-integrations#community-integrations). Machine-readable contract: OpenAPI communautés · JSON (/api/v1/community/public/openapi/v1). Access: public. Contrat public versionné pour les boutiques intégrées, la découverte de communautés et les passages entre pages avec la bonne langue. Canonical section: /fr-ch/developers#community-integrations."},{"title":"API fournisseurs","description":"Connectez les systèmes des fournisseurs agréés aux dossiers de production publiés, au statut d’intégration et aux parcours de webhooks ERP ou PLM. Human guide: Découvrir l’API fournisseurs (/fr-ch/developers/api-integrations#supplier-integrations). Machine-readable contract: OpenAPI fournisseurs · JSON (/api/v1/supplier/openapi/v1). Access: public. Contrat public pour préparer l’intégration et générer des clients. L’accès aux opérations fournisseurs reste soumis à autorisation. Canonical section: /fr-ch/developers#supplier-integrations."},{"title":"API identité d’entreprise","description":"Connectez les espaces d’entreprise approuvés à l’authentification unique, au provisionnement des utilisateurs et groupes et aux journaux d’audit d’identité. Human guide: Découvrir l’identité d’entreprise (/fr-ch/developers/api-integrations#enterprise-integrations). Machine-readable contract: OpenAPI identité d’entreprise · JSON (/api/v1/enterprise/identity/openapi/v1). Access: protected. Contrat protégé pour les espaces d’entreprise approuvés ; demandez l’accès avant d’utiliser ce point d’accès. Canonical section: /fr-ch/developers#enterprise-integrations."},{"title":"Agents IA et MCP","description":"Connectez un assistant IA via le Model Context Protocol. Découvrez les outils compatibles et préservez les choix de design, les droits et les confirmations requises de l’utilisateur. Human guide: Découvrir les agents IA et MCP (/fr-ch/developers/ai-agents-mcp). Machine-readable contract: Fiche publique du serveur MCP · JSON (/.well-known/mcp/server-card). Access: public. Document public de découverte pour les clients automatisés. La liste externe /api/v1/mcp/tools expose les métadonnées actuelles des outils ; chaque appel conserve ses règles de sécurité, d’espace de travail et de confirmation. Canonical section: /fr-ch/developers#mcp-tools."}]},{"heading":"De la première requête à la production","items":[{"title":"Step 1: Choisissez le contrat adapté à votre parcours","description":"Commencez par l’interface adaptée à vos utilisateurs et à votre modèle d’authentification : communauté intégrée, identité d’entreprise, opérations fournisseurs ou outils MCP pour assistants."},{"title":"Step 2: Validez l’authentification, les versions et les environnements","description":"Confirmez les en-têtes requis, les portées d’accès, les rappels attendus et les versions des contrats dans l’environnement de préparation avant de diriger du trafic de production."},{"title":"Step 3: Testez les parcours complets avant le lancement","description":"Vérifiez les requêtes, webhooks, provisionnement, suivi opérationnel et possibilités de retour arrière pour une intégration fiable dès la première utilisation réelle."}]},{"heading":"Ce que signifie « prêt pour la production »","paragraphs":["Une intégration de production demande plus qu’un point d’accès public. Utilisez ces critères pour déterminer si votre parcours est prêt pour les clients, fournisseurs, entreprises ou agents IA."],"items":[{"title":"Environnement de test et examen des accès","description":"Confirmez les contrats publics, les interfaces d’entreprise soumises à approbation et les identifiants ou rôles d’espace nécessaires avant le lancement."},{"title":"Éléments d’implémentation versionnés","description":"Documentez les clients générés, URL de rappel, portées d’authentification, versions des contrats et responsabilités de retour arrière avant d’activer le trafic de production."},{"title":"Suivi opérationnel","description":"Prévoyez les journaux, nouvelles tentatives, responsables d’assistance, états d’échec et contrôles de santé pour chaque parcours susceptible d’affecter une commande, un fournisseur ou un utilisateur d’entreprise."}]},{"heading":"Avant de commencer le développement","items":[{"title":"Quelle API MerchandAise utiliser ?","description":"Utilisez l’API communautés pour les sites de clubs et communautés, l’API fournisseurs pour les opérations autorisées des fournisseurs et l’API identité d’entreprise pour la connexion et le provisionnement. La référence API couvre les outils pour assistants ; le guide MCP explique comment les assistants IA découvrent et utilisent les outils compatibles."},{"title":"Peut-on consulter les spécifications sans compte ?","description":"Les spécifications OpenAPI des outils pour assistants, des communautés et des fournisseurs sont publiques. La spécification d’identité d’entreprise est protégée. Consulter une spécification publique n’autorise pas à exécuter des requêtes protégées ni à passer des commandes."},{"title":"Une intégration développeur est-elle nécessaire pour commander ?","description":"Non. Particuliers, clubs et entreprises peuvent utiliser le site MerchandAise pour explorer les produits compatibles et demander un devis. Les API sont un moyen facultatif de connecter vos systèmes ou votre expérience."},{"title":"Que préciser dans une demande d’intégration ?","description":"Décrivez les utilisateurs, les systèmes concernés, les informations à lire ou modifier et votre calendrier. Ajoutez les exigences de connexion, d’environnement et de rappel si vous les connaissez. L’équipe examine avec vous le contrat et le modèle d’accès adaptés."}]},{"heading":"Vous préparez une intégration sur mesure ?","paragraphs":["Présentez les systèmes concernés, le parcours que vous souhaitez prendre en charge et votre calendrier. Nous vous aidons à choisir le contrat, le modèle d’accès et les étapes de lancement adaptés."],"items":[{"title":"Discuter d’une intégration","description":"/fr-ch/contact/integrations"},{"title":"Découvrir l’offre entreprise","description":"/fr-ch/enterprise"}]}],"source":{"type":"page-copy","id":"Developers"}},"metadata":{"source":"route-owned-source","schema":"2025-11-05"}}