Développeurs

Construisez sur Behio.
API, SDK et MCP.

La plateforme qui fait tourner chaque boutique Behio vous est aussi ouverte. Un Storefront SDK typé, une API REST publique, des webhooks et un serveur MCP officiel. Pas de rétro-ingénierie, pas de bricolage.

Le Storefront SDK est un outil optionnel pour les développeurs qui créent une vitrine ou une intégration sur mesure. Démarrer une boutique à partir d’un modèle et la gérer au quotidien ne nécessite ni SDK, ni connaissances en code, ni équipe de développement interne. Je veux une boutique sans coder

60+
méthodes SDK
25+
hooks React
42
contrôleurs API
1000+
outils MCP
app/product/[slug]/page.tsx
1import { behio } from "@behio/storefront-sdk";
2 
3export default async function Page({ params }) {
4 const { data, error } = await behio.catalog.getProduct(params.slug);
5 if (error) return <NotFound />;
6 return <ProductView {...data} />;
7}
Interfaces

Quatre façons de vous connecter.

Storefront SDK

Un client TypeScript typé avec plus de 60 méthodes et plus de 25 hooks React. Un cœur sans dépendances, des bindings React optionnels.

catalogcartcheckoutauthreviewsreturns

API REST publique

42 contrôleurs couvrant tout le catalogue, le panier, les commandes et les clients. Authentification par clé API, limites de débit par clé.

RESTOpenAPIrate-limit

Webhooks

Des webhooks sortants fiables, avec nouvelles tentatives. Réagissez en temps réel aux commandes, aux paiements, aux réassorts et aux mouvements de stock.

order.createdstock.changedretry

Serveur MCP

Un serveur Model Context Protocol officiel. Connectez Behio à ChatGPT ou à Claude et pilotez votre boutique en ligne grâce à 1 000 outils typés.

MCPChatGPTClaude
Dans la boîte

Ce que reçoit un développeur

Pas de bidouillage autour d’une plateforme fermée. Une surface ouverte et typée, agréable à utiliser.

@behio/storefront-sdk sur npm

Installez-le avec une seule commande npm. Un cœur sans dépendances et des bindings React optionnels, sous licence MIT, sans dépendance à un fournisseur.

API typée avec autocomplétion

Toute la surface est typée à partir d’OpenAPI, votre éditeur vous suggère donc les méthodes, les paramètres et la forme des réponses. Vous détectez les erreurs pendant la saisie, pas en production.

Webhooks en temps réel

Réagissez aux commandes, aux paiements et aux mouvements de stock. Les webhooks sortants réessaient automatiquement, aucun événement ne vous échappe.

Documentation sur sdk.behio.com

Une documentation complète avec des exemples, un démarrage rapide et un serveur MCP dédié. Ainsi qu’un llms.txt pour que l’IA puisse aussi vous aider dans l’intégration.

API de type Result

Pas d’exceptions. Juste des données et une erreur.

Chaque appel renvoie { data, error } avec 19 codes d’erreur sémantiques. Le SDK sait quand une nouvelle tentative vaut la peine (5xx, 429, coupure réseau) et rafraîchit le jeton en arrière-plan.

VALIDATION_ERRORUNAUTHORIZEDDISCOUNT_EXPIREDOUT_OF_STOCKRATE_LIMITED
cart.ts
1const { data, error } = await behio.cart.addItem({
2 sku: "LEN-PRE-240", qty: 2,
3});
4 
5if (error?.code === "OUT_OF_STOCK") {
6 toast("Épuisé");
7}
Questions fréquentes

FAQ développeurs

Puis-je utiliser mon propre frontend ?

Oui. Behio est conçu selon une approche API-first. Connectez votre propre Next.js, Nuxt ou tout autre framework via le SDK et l’API REST publique, et pilotez le catalogue, le panier et le tunnel de commande depuis n’importe où. La vitrine n’a pas besoin d’être la nôtre.

À quoi ressemble le développement en local ?

Vous installez le SDK, générez une clé API et appelez immédiatement de vrais endpoints. Les clés sont PUBLIC pour le navigateur et PRIVATE pour le serveur, avec des limites de débit par clé, pour tester en toute sécurité.

Comment gérez-vous les versions ?

Nous publions le SDK sur npm selon semver et gardons l’API publique rétrocompatible. Les changements sont documentés, vous savez donc toujours sur quoi vous construisez.

Démarrage rapide

De zéro aux données en trois étapes.

01

Installer le SDK

$ npm i @behio/storefront-sdk
02

Initialiser le client

$ behio.init({ apiKey })
03

Récupérer les données

$ await behio.catalog.getProducts()