Para desarrolladores

Construye sobre Behio.
API, SDK y MCP.

La misma plataforma que impulsa cada tienda online de Behio también está abierta para ti. Un Storefront SDK tipado, una API REST pública, webhooks y un servidor MCP oficial. Sin ingeniería inversa ni apaños.

El Storefront SDK es una herramienta opcional para desarrolladores que crean un escaparate o una integración a medida. Abrir una tienda desde una plantilla y gestionarla a diario no requiere el SDK, conocimientos de programación ni un equipo de desarrollo propio. Quiero una tienda sin programar

60+
métodos del SDK
25+
hooks de React
42
controladores de la API
1000+
herramientas 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

Cuatro formas de conectarte.

Storefront SDK

Un cliente tipado de TypeScript con más de 60 métodos y más de 25 hooks de React. Núcleo sin dependencias y enlaces opcionales para React.

catalogcartcheckoutauthreviewsreturns

API REST pública

42 controladores que cubren todo el catálogo, el carrito, los pedidos y los clientes. Autenticación con clave de API y límites de solicitudes por clave.

RESTOpenAPIrate-limit

Webhooks

Webhooks salientes fiables con reintentos. Reacciona en tiempo real a pedidos, pagos, reposiciones y movimientos de stock.

order.createdstock.changedretry

Servidor MCP

Un servidor oficial de Model Context Protocol. Conecta Behio a ChatGPT o Claude y gestiona tu tienda online con 1000 herramientas tipadas.

MCPChatGPTClaude
Qué incluye

Qué obtiene un desarrollador

Sin trucos alrededor de una plataforma cerrada. Una superficie abierta y tipada sobre la que da gusto construir.

@behio/storefront-sdk desde npm

Instálalo con un solo comando de npm. Un núcleo sin dependencias más enlaces opcionales para React, licencia MIT y sin dependencia del proveedor.

API tipada con autocompletado

Toda la superficie está tipada a partir de OpenAPI, así que tu editor te sugiere métodos, parámetros y la forma de las respuestas. Detectas los errores mientras escribes, no en producción.

Webhooks en tiempo real

Reacciona a pedidos, pagos y movimientos de stock. Los webhooks salientes tienen reintentos, así que no se te escapa ningún evento.

Documentación en sdk.behio.com

Documentación completa con ejemplos, un inicio rápido y un servidor MCP dedicado. Además de llms.txt, para que la IA también pueda ayudarte con la integración.

API con tipo Result

Sin excepciones. Solo datos y error.

Cada llamada devuelve { data, error } con 19 códigos de error semánticos. El SDK sabe cuándo vale la pena reintentar (5xx, 429, caída de red) y renueva el token en segundo plano.

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("Agotado");
7}
Preguntas frecuentes

Preguntas frecuentes de desarrolladores

¿Puedo usar mi propio frontend?

Sí. Behio está diseñado desde el principio en torno a su API. Conecta tu propio Next.js, Nuxt o cualquier otra cosa mediante el SDK y la API REST pública y gestiona el catálogo, el carrito y el checkout desde donde quieras. El escaparate no tiene por qué ser nuestro.

¿Cómo es el desarrollo en local?

Instalas el SDK, generas una clave de API y llamas a endpoints reales desde el primer momento. Las claves son PUBLIC para el navegador y PRIVATE para el servidor, con límites de solicitudes por clave, así que pruebas con seguridad.

¿Cómo se gestiona el versionado?

Publicamos el SDK en npm siguiendo semver y mantenemos la API pública compatible con versiones anteriores. Los cambios están documentados, así que siempre sabes sobre qué estás construyendo.

Inicio rápido

De cero a datos en tres pasos.

01

Instala el SDK

$ npm i @behio/storefront-sdk
02

Inicializa el cliente

$ behio.init({ apiKey })
03

Obtén los datos

$ await behio.catalog.getProducts()