# API Merchandise et contrats d'intégration | MerchandAise

- slug: developers-api-integrations
- locale: fr
- localeResolved: fr
- canonical: https://www.merchandaise.com/fr/developers/api-integrations

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.

## Conserver une source unique de vérité
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.
Where MerchandAise processes the buyer transaction, Hutter Products GmbH is the contracting seller and Merchant of Record under the MerchandAise brand. Supplier identity and contact details stay private except where disclosure is required, and production still requires digital-proof approval, confirmed producibility, mandatory technical checks, and the sample approvals applicable to the exact accepted order.

## Surfaces API et d'intégration
- **Docs API — outils assistant:** 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). Accès: 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.
- **API d'intégration communautaire:** 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). Accès: 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.
- **API fournisseur:** 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). Accès: 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.
- **API d'identité entreprise:** 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). Accès: Protégé. 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.

## Choisissez le contrat avant le code
- **Step 1: Cartographiez le parcours utilisateur:** 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.
- **Step 2: Confirmez la limite d'accès:** 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.
- **Step 3: Démontrez la continuité d'état:** 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.

## Ce que chaque intégration doit préserver
- **Un état versionné unique:** 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.
- **Confidentialité commerciale et fournisseur:** 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.
- **Approbation avant production:** Une vue 3D ne constitue pas une preuve physique. Le devis confirmé explique les choix d’échantillons disponibles, leurs coûts, limites et délais. Avant la production en série, validez le bon à tirer numérique exact et terminez les vérifications techniques obligatoires ainsi que les validations d’échantillons requises ou choisies. Les exigences des commandes déjà acceptées restent obligatoires.

## Avant la mise en production
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.
- **Accès et environnements:** Confirmez la version du contrat, l'espace de travail approuvé, les scopes d'authentification, sandbox, identifiants de production et destinations de callback.
- **Pannes et récupération:** Définissez retries, idempotence, timeouts, erreurs visibles client, observabilité, responsabilité du support et rollback avant la mise en production.
- **Preuve de bout en bout:** 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.

## FAQ
- **Par quelle surface d'intégration dois-je commencer ?:** 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.
- **Un contrat public signifie-t-il accès en production public ?:** 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.
- **Une intégration peut-elle exposer des fournisseurs ou contourner des approbations ?:** No. Supplier identity and contact details remain private except where disclosure is required, MerchandAise owns the buyer relationship, and order-affecting actions must preserve the configured digital-proof, technical, and order-specific sample approval requirements.

## Apportez-nous le flux, pas une architecture définitive.
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.
- **Planifier une intégration:** /fr/contact?intent=api-integration-review
- **Explorer les agents AI et MCP:** /fr/developers/ai-agents-mcp