# Hub sviluppatori: API, OpenAPI e MCP | MerchandAise

- slug: developers
- locale: it
- localeResolved: it
- canonical: https://www.merchandaise.com/it/developers

Integra il merchandising personalizzato con le API MerchandAise. Esplora OpenAPI, community incorporate, processi dei fornitori, SSO aziendale e strumenti MCP.

## Hub sviluppatori MerchandAise
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.

## Per i sistemi che accompagnano il tuo programma di merchandising
- **Responsabili delle community:** Integra negozi, passaggi al configuratore e processi delle community nei siti di club, leghe e aziende usando contratti pubblici con versione.
- **Team aziendali e partner della piattaforma:** Collega portali acquisti, sistemi di identità e operazioni interne ai processi di merchandising senza ricostruire la logica di approvazioni e fornitori.
- **Sviluppatori di agenti IA e automazioni:** Offri agli assistenti accesso strutturato agli strumenti per ricerca, preventivi e operazioni approvate tramite endpoint compatibili con MCP.

## Trova la tua integrazione
- **Documentazione API e OpenAPI:** 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/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/developers#api-docs.
- **API Community:** 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/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/developers#community-integrations.
- **API Fornitori:** 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/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/developers#supplier-integrations.
- **API Identità aziendale:** 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/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/developers#enterprise-integrations.
- **Agenti IA e MCP:** 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/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/developers#mcp-tools.

## Dalla prima richiesta alla produzione
- **Step 1: Scegli il contratto che corrisponde al tuo flusso di lavoro:** Parti dall’ambito adatto al tuo utente e modello di autenticazione: community incorporata, identità aziendale, operazioni dei fornitori o strumenti MCP per gli assistenti.
- **Step 2: Convalida l'autenticazione, il controllo delle versioni e i limiti dell'ambiente:** Conferma intestazioni, ambiti di autorizzazione, requisiti di callback e versioni del contratto nell’ambiente di test prima di instradare il traffico di produzione.
- **Step 3: Testa i flussi di lavoro end-to-end prima del lancio:** Verifica richieste, webhook, provisioning, osservabilità e percorsi di rollback in modo che l'integrazione sia affidabile fin dal primo utilizzo live.

## Cosa significa essere pronti per la produzione
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.
- **Sandbox e verifica degli accessi:** 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.
- **Prove dell’implementazione con versione:** Documenta client generati, URL di callback, ambiti di autenticazione, versioni dei contratti e responsabilità del ripristino prima di abilitare il traffico di produzione.
- **Monitoraggio operativo:** 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.

## Prima di iniziare a sviluppare
- **Quale API MerchandAise dovrei usare?:** 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.
- **Posso leggere le specifiche API senza un account?:** 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.
- **Serve un’integrazione sviluppatori per ordinare un prodotto?:** 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.
- **Cosa devo includere in una richiesta di integrazione?:** 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.

## Stai pianificando un’integrazione personalizzata?
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.
- **Parliamo di un’integrazione:** /it/contact/integrations
- **Esplora le soluzioni aziendali:** /it/enterprise