Costruisci sopra Behio.
API, SDK e MCP.
La stessa piattaforma che fa funzionare ogni negozio online su Behio è aperta anche a te. Uno Storefront SDK tipizzato, un’API REST pubblica, webhook e un server MCP ufficiale. Nessun reverse engineering, nessun espediente.
Lo Storefront SDK è uno strumento opzionale per gli sviluppatori che realizzano una vetrina o un’integrazione su misura. Per avviare un negozio da un modello e gestirlo ogni giorno non servono l’SDK, competenze di programmazione né un team di sviluppo interno. Voglio un negozio senza programmare
Quattro modi per collegarti.
Storefront SDK
Un client TypeScript tipizzato con oltre 60 metodi e più di 25 hook React. Core senza dipendenze, binding React opzionali.
API REST pubblica
42 controller che coprono l’intero catalogo, il carrello, gli ordini e i clienti. Autenticazione con chiave API, limiti di richieste per chiave.
Webhook
Webhook in uscita affidabili, con nuovi tentativi. Reagisci in tempo reale a ordini, pagamenti, rifornimenti e movimenti di magazzino.
Server MCP
Un server ufficiale Model Context Protocol. Collega Behio a ChatGPT o Claude e gestisci il tuo negozio online con 1000 strumenti tipizzati.
Cosa ottiene uno sviluppatore
Niente acrobazie intorno a una piattaforma chiusa. Una superficie aperta e tipizzata, su cui è piacevole costruire.
@behio/storefront-sdk da npm
Lo installi con un solo comando npm. Un core senza dipendenze più binding React opzionali, licenza MIT, nessun vincolo con il fornitore.
API tipizzata con completamento automatico
Tutta la superficie è tipizzata a partire da OpenAPI, quindi l’editor ti suggerisce metodi, parametri e forma delle risposte. Gli errori li scopri mentre scrivi, non in produzione.
Webhook in tempo reale
Reagisci a ordini, pagamenti e movimenti di magazzino. I webhook in uscita prevedono nuovi tentativi, così nessun evento ti sfugge.
Documentazione su sdk.behio.com
Documentazione completa con esempi, una guida rapida e un server MCP dedicato. In più llms.txt, così anche l’AI può aiutarti con l’integrazione.
Nessuna eccezione. Solo dati ed errore.
Ogni chiamata restituisce { data, error } con 19 codici di errore semantici. L’SDK sa quando conviene riprovare (5xx, 429, caduta di rete) e rinnova il token in background.
FAQ per sviluppatori
Posso usare un mio frontend?
Sì. Behio è API-first. Collega il tuo Next.js, Nuxt o qualsiasi altra cosa tramite l’SDK e l’API REST pubblica e gestisci catalogo, carrello e checkout da dove vuoi. La vetrina non deve per forza essere la nostra.
Com’è lo sviluppo in locale?
Installi l’SDK, generi una chiave API e chiami subito gli endpoint reali. Le chiavi sono PUBLIC per il browser e PRIVATE per il server, con limiti di richieste per chiave, così fai i test in sicurezza.
Come gestite il versionamento?
Pubblichiamo l’SDK su npm seguendo il semver e manteniamo l’API pubblica retrocompatibile. Le modifiche sono documentate, così sai sempre su cosa stai costruendo.