{"pageKey":"Developers","slug":"developers","locale":"it-CH","localeResolved":"it-CH","fallbackApplied":false,"version":"developers@2026-07-21T09:39:17.914Z","lastModified":"2026-07-21T09:39:17.914Z","canonicalUrl":"https://www.merchandaise.com/it-ch/developers","payload":{"slug":"developers","purpose":"llm-developers","title":"Hub sviluppatori: API, OpenAPI e MCP | MerchandAise","description":"Integra il merchandising personalizzato con le API MerchandAise. Esplora OpenAPI, community incorporate, processi dei fornitori, SSO aziendale e strumenti MCP.","sections":[{"heading":"Hub sviluppatori MerchandAise","paragraphs":["Collega il tuo sito, i sistemi aziendali o un assistente IA a MerchandAise. Esplora le API per il design dei prodotti, i negozi delle community, le operazioni dei fornitori e l’identità aziendale, con specifiche OpenAPI e documentazione MCP per guidare l’integrazione."]},{"heading":"Per i sistemi che accompagnano il tuo programma di merchandising","items":[{"title":"Responsabili delle community","description":"Integra negozi, passaggi al configuratore e processi delle community nei siti di club, leghe e aziende usando contratti pubblici con versione."},{"title":"Team aziendali e partner della piattaforma","description":"Collega portali acquisti, sistemi di identità e operazioni interne ai processi di merchandising senza ricostruire la logica di approvazioni e fornitori."},{"title":"Sviluppatori di agenti IA e automazioni","description":"Offri agli assistenti accesso strutturato agli strumenti per ricerca, preventivi e operazioni approvate tramite endpoint compatibili con MCP."}]},{"heading":"Trova la tua integrazione","items":[{"title":"Documentazione API e OpenAPI","description":"Trova il riferimento API per gli strumenti degli assistenti e le sessioni di design, poi scegli il contratto per community, fornitori o aziende adatto al tuo processo. Human guide: Esplora la documentazione API (/it-ch/developers/api-integrations). Machine-readable contract: OpenAPI JSON degli strumenti per assistenti (/api/docs/openapi.json). Access: public. Riferimento pubblico per le API degli assistenti e degli strumenti. L’accesso in produzione e le operazioni che influiscono sugli ordini richiedono comunque l’autorizzazione applicabile. Canonical section: /it-ch/developers#api-docs."},{"title":"API Community","description":"Collega il sito di un club o di una community alle informazioni pubbliche della community, all’invio dei design, ai voti e ai passaggi per l’approvazione degli ordini. Human guide: Esplora l’API Community (/it-ch/developers/api-integrations#community-integrations). Machine-readable contract: OpenAPI JSON della Community (/api/v1/community/public/openapi/v1). Access: public. Contratto pubblico con versione per negozi incorporati, ricerca di community e passaggi tra pagine che rispettano la lingua scelta. Canonical section: /it-ch/developers#community-integrations."},{"title":"API Fornitori","description":"Collega i sistemi dei fornitori approvati ai pacchetti di produzione rilasciati, allo stato di onboarding e ai processi con webhook ERP o PLM. Human guide: Esplora l’API Fornitori (/it-ch/developers/api-integrations#supplier-integrations). Machine-readable contract: OpenAPI JSON dei fornitori (/api/v1/supplier/openapi/v1). Access: public. Contratto pubblico per la pianificazione e la generazione di client. L’accesso operativo dei fornitori resta soggetto ad autorizzazione. Canonical section: /it-ch/developers#supplier-integrations."},{"title":"API Identità aziendale","description":"Collega gli spazi di lavoro aziendali approvati all’accesso unico, alla gestione di utenti e gruppi e ai registri di controllo dell’identità. Human guide: Esplora l’identità aziendale (/it-ch/developers/api-integrations#enterprise-integrations). Machine-readable contract: OpenAPI JSON dell’identità aziendale (/api/v1/enterprise/identity/openapi/v1). Access: protected. Contratto protetto per spazi di lavoro aziendali approvati. Richiedi l’accesso prima di usare questo endpoint. Canonical section: /it-ch/developers#enterprise-integrations."},{"title":"Agenti IA e MCP","description":"Collega un assistente IA tramite il Model Context Protocol. Scopri gli strumenti supportati e conserva le scelte di design, i permessi e le conferme richieste dell’utente. Human guide: Esplora gli agenti IA e MCP (/it-ch/developers/ai-agents-mcp). Machine-readable contract: Scheda pubblica del server MCP in JSON (/.well-known/mcp/server-card). Access: public. Documento pubblico per la ricerca automatica dei client. L’elenco degli strumenti esterni in /api/v1/mcp/tools espone i metadati attuali; ogni chiamata rispetta comunque i limiti dichiarati di sicurezza, spazio di lavoro e conferma. Canonical section: /it-ch/developers#mcp-tools."}]},{"heading":"Dalla prima richiesta alla produzione","items":[{"title":"Step 1: Scegli il contratto che corrisponde al tuo flusso di lavoro","description":"Parti dall’ambito adatto al tuo utente e modello di autenticazione: community incorporata, identità aziendale, operazioni dei fornitori o strumenti MCP per gli assistenti."},{"title":"Step 2: Convalida l'autenticazione, il controllo delle versioni e i limiti dell'ambiente","description":"Conferma intestazioni, ambiti di autorizzazione, requisiti di callback e versioni del contratto nell’ambiente di test prima di instradare il traffico di produzione."},{"title":"Step 3: Testa i flussi di lavoro end-to-end prima del lancio","description":"Verifica richieste, webhook, provisioning, osservabilità e percorsi di rollback in modo che l'integrazione sia affidabile fin dal primo utilizzo live."}]},{"heading":"Cosa significa essere pronti per la produzione","paragraphs":["Un’integrazione di produzione richiede più di un endpoint pubblico. Usa queste verifiche per decidere se il processo è pronto per clienti, fornitori, aziende o agenti IA."],"items":[{"title":"Sandbox e verifica degli accessi","description":"Verifica quali contratti sono pubblici, quali superfici aziendali richiedono l'approvazione e quali credenziali o ruoli dell'area di lavoro sono necessari prima del lancio."},{"title":"Prove dell’implementazione con versione","description":"Documenta client generati, URL di callback, ambiti di autenticazione, versioni dei contratti e responsabilità del ripristino prima di abilitare il traffico di produzione."},{"title":"Monitoraggio operativo","description":"Pianifica registri, nuovi tentativi, responsabilità dell’assistenza, stati di errore e controlli di integrità per ogni processo che può influire su ordini, fornitori o utenti aziendali."}]},{"heading":"Prima di iniziare a sviluppare","items":[{"title":"Quale API MerchandAise dovrei usare?","description":"Usa l’API Community per i siti di club e community, l’API Fornitori per le operazioni dei fornitori approvati e l’API Identità aziendale per accesso e provisioning aziendale. Il riferimento API comprende gli strumenti per assistenti; la guida MCP spiega come gli assistenti IA scoprono e usano gli strumenti supportati."},{"title":"Posso leggere le specifiche API senza un account?","description":"Le specifiche OpenAPI degli strumenti per assistenti, della Community e dei Fornitori sono pubbliche. La specifica Identità aziendale è protetta. Leggere una specifica pubblica non autorizza richieste protette o ordini."},{"title":"Serve un’integrazione sviluppatori per ordinare un prodotto?","description":"No. Persone, club e aziende possono usare il sito MerchandAise per esplorare i prodotti supportati e richiedere un preventivo. Le API sono un modo facoltativo per collegare i tuoi sistemi o la tua esperienza."},{"title":"Cosa devo includere in una richiesta di integrazione?","description":"Descrivi chi la userà, i sistemi coinvolti, le informazioni da leggere o aggiornare e i tempi previsti. Includi i requisiti di accesso, ambiente e callback se noti. Il team verifica con te il contratto e il modello di accesso appropriati."}]},{"heading":"Stai pianificando un’integrazione personalizzata?","paragraphs":["Indica i sistemi coinvolti, il processo da supportare e i tempi di introduzione. Ti aiutiamo a scegliere il contratto, il modello di accesso e la sequenza di lancio adatti."],"items":[{"title":"Parliamo di un’integrazione","description":"/it-ch/contact/integrations"},{"title":"Esplora le soluzioni aziendali","description":"/it-ch/enterprise"}]}],"source":{"type":"page-copy","id":"Developers"}},"metadata":{"source":"page-content","schema":"2025-11-05"}}