Plateforme développeurs MerchandAise
Un flux produit. Quatre façons de se connecter.
Connectez un site, une communauté, une opération fournisseur ou un espace entreprise au même design versionné, devis, approbation et état de commande. Commencez par le contrat publié, puis planifiez avec nous l'accès et le déploiement en production.
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.
01 — Contrats
Surfaces API et d'intégration
01
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.
Guide d'implémentation
Ouvrir les docs outils assistantContrat machine
OpenAPI JSON — outils assistant/api/docs/openapi.jsonRé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.
02
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.
Contrat machine
OpenAPI JSON — communauté/api/v1/community/public/openapi/v1Contrat versionné public pour les embeds de vitrine, la découverte communautaire et les handoffs adaptés à la locale.
03
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.
Contrat machine
OpenAPI JSON — fournisseur/api/v1/supplier/openapi/v1Contrat public pour planification et génération de clients. L'accès opérationnel fournisseur reste soumis à autorisation.
04
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.
Contrat machine
OpenAPI JSON — identité entreprise/api/v1/enterprise/identity/openapi/v1Contrat protégé pour espaces de travail entreprise approuvés ; demandez l'accès avant d'utiliser ce endpoint.
02 — Guide d'implémentation
Choisissez le contrat avant le code
- 01
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.
- 02
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.
- 03
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.
03 — Ce que chaque intégration doit préserver
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.
04
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.