Fejlesztőknek

Építs a Behióra.
API, SDK és MCP.

Ugyanaz a platform, amely minden Behio-webáruházat működtet, neked is nyitva áll. Típusos Storefront SDK, nyilvános REST API, webhookok és hivatalos MCP-szerver. Nincs visszafejtés, nincsenek kerülőutak.

A Storefront SDK opcionális eszköz azoknak a fejlesztőknek, akik egyedi kirakatot vagy integrációt építenek. Ha sablonból indítod a webáruházat, és napi szinten kezeled, nincs szükséged SDK-ra, programozói tudásra vagy saját fejlesztőcsapatra. Programozás nélkül szeretnék webáruházat

60+
SDK-metódus
25+
React hook
42
API-kontroller
1000+
MCP-eszköz
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}
Interfészek

Négy módja a kapcsolódásnak.

Storefront SDK

Típusos TypeScript-kliens több mint 60 metódussal és több mint 25 React hookkal. Függőségek nélküli mag, opcionális React-kötésekkel.

catalogcartcheckoutauthreviewsreturns

Nyilvános REST API

42 kontroller, amely lefedi a teljes katalógust, a kosarat, a rendeléseket és az ügyfeleket. Hitelesítés API-kulccsal, kulcsonkénti kéréskorlátokkal.

RESTOpenAPIrate-limit

Webhookok

Megbízható kimenő webhookok újrapróbálkozással. Reagálj valós időben a rendelésekre, a fizetésekre, az újra raktárra kerülő termékekre és a készletmozgásokra.

order.createdstock.changedretry

MCP-szerver

Hivatalos Model Context Protocol szerver. Kösd össze a Behiót a ChatGPT-vel vagy a Claude-dal, és irányítsd a webáruházadat 1000 típusos eszközzel.

MCPChatGPTClaude
A csomagban

Mit kap a fejlesztő

Nem kell egy zárt platform körül bütykölni. Nyitott, típusos felület, amelyre öröm építeni.

@behio/storefront-sdk az npm-ről

Egyetlen npm-paranccsal telepíted. Függőségek nélküli mag és opcionális React-kötések, MIT-licenc, szolgáltatói bezártság nélkül.

Típusos API automatikus kiegészítéssel

A teljes felület típusai az OpenAPI-ból készülnek, így a szerkesztőd felajánlja a metódusokat, a paramétereket és a válaszok szerkezetét. A hibákat gépelés közben veszed észre, nem élesben.

Valós idejű webhookok

Reagálj a rendelésekre, a fizetésekre és a készletmozgásokra. A kimenő webhookok újrapróbálkoznak, így egyetlen esemény sem csúszik el melletted.

Dokumentáció: sdk.behio.com

Teljes dokumentáció példákkal, gyors kezdéssel és saját MCP-szerverrel. Plusz llms.txt, hogy az integrációban az AI is segíthessen.

Result típusú API

Nincsenek kivételek. Csak adat és hiba.

Minden hívás ezt adja vissza: { data, error }, 19 szemantikus hibakóddal. Az SDK tudja, mikor érdemes újrapróbálkozni (5xx, 429, hálózati kiesés), és a háttérben frissíti a tokent.

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("Elfogyott");
7}
Gyakori kérdések

Fejlesztői GYIK

Használhatom a saját frontendemet?

Igen. A Behio API-first. Kösd be a saját Next.js, Nuxt vagy bármilyen más frontendedet az SDK-n és a nyilvános REST API-n keresztül, és irányítsd a katalógust, a kosarat és a pénztárt bárhonnan. A kirakatnak nem kell a miénknek lennie.

Hogyan néz ki a helyi fejlesztés?

Telepíted az SDK-t, létrehozol egy API-kulcsot, és azonnal valódi végpontokat hívhatsz. A kulcsok PUBLIC típusúak a böngészőhöz és PRIVATE típusúak a szerverhez, kulcsonkénti kéréskorláttal, így biztonságosan tesztelhetsz.

Hogyan kezelitek a verziózást?

Az SDK-t a szemantikus verziózás (semver) szerint tesszük közzé az npm-en, a nyilvános API pedig visszafelé kompatibilis marad. A változásokat dokumentáljuk, így mindig tudod, mire építesz.

Gyors kezdés

Nulláról az adatokig három lépésben.

01

Telepítsd az SDK-t

$ npm i @behio/storefront-sdk
02

Inicializáld a klienst

$ behio.init({ apiKey })
03

Kérd le az adatokat

$ await behio.catalog.getProducts()