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.

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.

01 — Contrats

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.

Accès: public

Guide d'implémentation

Ouvrir les docs outils assistant

Contrat machine

OpenAPI JSON — outils assistant

/api/docs/openapi.json

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.

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.

Accès: public

Contrat machine

OpenAPI JSON — communauté

/api/v1/community/public/openapi/v1

Contrat versionné public pour les embeds de vitrine, la découverte communautaire et les handoffs adaptés à la locale.

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.

Accès: public

Contrat machine

OpenAPI JSON — fournisseur

/api/v1/supplier/openapi/v1

Contrat public pour planification et génération de clients. L'accès opérationnel fournisseur reste soumis à autorisation.

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.

Accès: protected

Contrat machine

OpenAPI JSON — identité entreprise

/api/v1/enterprise/identity/openapi/v1

Contrat 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 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.

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 ?

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.

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 Explorer les agents AI et MCP

Conserver une source unique de vérité

Choisissez le contrat avant le code

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.

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.

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

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 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.

FAQ

Par quelle surface d'intégration dois-je commencer ?

Un contrat public signifie-t-il accès en production public ?

Une intégration peut-elle exposer des fournisseurs ou contourner des approbations ?