Pro vývojáře

Stavte nad Behio.
API, SDK a MCP.

Stejná platforma, na které běží každý e-shop od Behio, je otevřená i vám. Typed Storefront SDK, veřejné REST API, webhooky a oficiální MCP server. Žádné reverzní inženýrství, žádné workaroundy.

60+
SDK metod
25+
React hooků
42
API controllerů
1000+
MCP nástrojů
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}
Rozhraní

Čtyři způsoby, jak se napojit.

Storefront SDK

Typed TypeScript klient s 60+ metodami a 25+ React hooky. Zero-dependency core, volitelné React bindings.

catalogcartcheckoutauthreviewsreturns

Public REST API

42 controllerů pokrývajících celý katalog, košík, objednávky i zákazníky. API-key autentizace, rate limity per klíč.

RESTOpenAPIrate-limit

Webhooky

Spolehlivé odchozí webhooky s retry. Reagujte na objednávky, platby, naskladnění i pohyby skladu v reálném čase.

order.createdstock.changedretry

MCP server

Oficiální Model Context Protocol server. Napojte Behio na ChatGPT nebo Claude a ovládejte e-shop přes 1000 typed nástrojů.

MCPChatGPTClaude
V balíku

Co dostane vývojář

Žádné hackování kolem uzavřené platformy. Otevřený, typovaný povrch, na kterém se dobře staví, od prvního e-shopu po vlastní integraci. Všechno, co běží pod každým e-shopem Behio, je dostupné i vám.

@behio/storefront-sdk z npm

Nainstalujete jedním příkazem z npm. Zero-dependency jádro plus volitelné React bindings, MIT licence, žádný vendor lock.

Typed API s napovídáním

Celý povrch je typovaný z OpenAPI, takže editor napovídá metody, parametry i tvary odpovědí. Chyby chytíte při psaní, ne až v produkci.

Webhooky v reálném čase

Reagujte na objednávky, platby i pohyby skladu. Odchozí webhooky mají retry, takže vám žádná událost neuteče.

Dokumentace na sdk.behio.com

Kompletní docs s příklady, quickstartem a vlastním MCP serverem. K tomu llms.txt, aby vám s integrací pomohla i AI.

Result-type API

Žádné výjimky. Jen data a error.

Každé volání vrací { data, error } s 19 sémantickými kódy chyb. SDK samo pozná, kdy se vyplatí opakovat (5xx, 429, výpadek sítě) a obnoví token na pozadí.

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("Vyprodáno");
7}
Časté dotazy

Časté dotazy vývojářů

Můžu použít vlastní frontend?

Ano. Behio je API-first. Napojíte vlastní Next.js, Nuxt nebo cokoliv jiného přes SDK a veřejné REST API a katalog, košík i checkout řídíte odkudkoliv. Storefront nemusí být od nás, backend, sklad, fakturaci i objednávky si necháte na Behiu a frontend postavíte přesně podle sebe.

Jak vypadá lokální vývoj?

Nainstalujete SDK, vygenerujete si API klíč a rovnou voláte reálné endpointy, žádné složité prostředí navíc. Klíče jsou PUBLIC pro prohlížeč a PRIVATE pro server, s rate limity per klíč, takže testujete v bezpečí a nic si neposíláte v otevřené podobě.

Jak řešíte verzování?

SDK vydáváme na npm podle semveru a veřejné API držíme zpětně kompatibilní. Změny píšeme do dokumentace, ať víte, na čem stavíte.

Quickstart

Od nuly k datům za tři kroky.

01

Nainstalujte SDK

$ npm i @behio/storefront-sdk
02

Inicializujte klienta

$ behio.init({ apiKey })
03

Načtěte data

$ await behio.catalog.getProducts()