Pre vývojárov

Stavajte na Behiu.
API, SDK a MCP.

Rovnaká platforma, na ktorej beží každý e-shop v Behiu, je otvorená aj vám. Typované Storefront SDK, verejné REST API, webhooky a oficiálny MCP server. Žiadny reverse engineering, žiadne obchádzky.

Storefront SDK je voliteľný nástroj pre vývojárov, ktorí chcú vytvoriť vlastný predajný web alebo napojenie. Na založenie e-shopu zo šablóny ani na jeho bežnú správu nepotrebujete SDK, znalosť kódu ani vlastný vývojový tím. Chcem e-shop bez programovania

60+
metód SDK
25+
React hookov
42
API kontrolérov
1000+
MCP nástrojov
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}
Rozhrania

Štyri spôsoby, ako sa pripojiť.

Storefront SDK

Typovaný klient v TypeScripte s viac ako 60 metódami a viac ako 25 React hookmi. Jadro bez závislostí, voliteľné väzby na React.

catalogcartcheckoutauthreviewsreturns

Verejné REST API

42 kontrolérov pokrývajúcich celý katalóg, košík, objednávky a zákazníkov. Overovanie API kľúčom, limity požiadaviek pre každý kľúč.

RESTOpenAPIrate-limit

Webhooky

Spoľahlivé odchádzajúce webhooky s opakovaním. Reagujte na objednávky, platby, naskladnenia a pohyby na sklade v reálnom čase.

order.createdstock.changedretry

MCP server

Oficiálny server Model Context Protocol. Pripojte Behio k ChatGPT alebo Claude a riaďte e-shop cez 1000 typovaných nástrojov.

MCPChatGPTClaude
V balení

Čo vývojár dostane

Žiadne hackovanie okolo uzavretej platformy. Otvorené, typované rozhranie, na ktorom sa príjemne stavia.

@behio/storefront-sdk z npm

Nainštalujete ho jedným príkazom npm. Jadro bez závislostí plus voliteľné väzby na React, licencia MIT, žiadne uzamknutie u dodávateľa.

Typované API s automatickým dopĺňaním

Celé rozhranie je typované z OpenAPI, takže váš editor navrhuje metódy, parametre aj tvar odpovedí. Chyby zachytíte pri písaní, nie v produkcii.

Webhooky v reálnom čase

Reagujte na objednávky, platby a pohyby na sklade. Odchádzajúce webhooky sa opakujú, takže vám žiadna udalosť neujde.

Dokumentácia na sdk.behio.com

Kompletná dokumentácia s príkladmi, rýchlym štartom a samostatným MCP serverom. K tomu llms.txt, aby vám s integráciou mohla pomôcť aj AI.

API s typom Result

Žiadne výnimky. Len údaje a chyba.

Každé volanie vracia { data, error } s 19 sémantickými chybovými kódmi. SDK vie, kedy sa oplatí skúsiť to znova (5xx, 429, výpadok siete), a token obnovuje 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("Vypredané");
7}
Časté otázky

Časté otázky vývojárov

Môžem použiť vlastný frontend?

Áno. Behio je postavené ako API-first. Pripojte vlastný Next.js, Nuxt alebo čokoľvek iné cez SDK a verejné REST API a ovládajte katalóg, košík a pokladňu odkiaľkoľvek. Predajný web nemusí byť náš.

Ako vyzerá lokálny vývoj?

Nainštalujete SDK, vygenerujete API kľúč a hneď voláte skutočné endpointy. Kľúče sú PUBLIC pre prehliadač a PRIVATE pre server, s limitmi požiadaviek pre každý kľúč, takže testujete bezpečne.

Ako riešite verzovanie?

SDK publikujeme do npm podľa semver a verejné API udržiavame spätne kompatibilné. Zmeny sú zdokumentované, takže vždy viete, na čom staviate.

Rýchly štart

Od nuly k údajom v troch krokoch.

01

Nainštalujte SDK

$ npm i @behio/storefront-sdk
02

Inicializujte klienta

$ behio.init({ apiKey })
03

Načítajte údaje

$ await behio.catalog.getProducts()