Dla programistów

Buduj na Behio.
API, SDK i MCP.

Ta sama platforma, na której działa każdy sklep Behio, jest otwarta także dla Ciebie. Typowany Storefront SDK, publiczne REST API, webhooki i oficjalny serwer MCP. Bez inżynierii wstecznej i bez obejść.

Storefront SDK to opcjonalne narzędzie dla programistów, którzy budują własną witrynę sklepu lub integrację. Uruchomienie sklepu z szablonu i codzienne zarządzanie nim nie wymaga SDK, umiejętności programowania ani własnego zespołu programistów. Chcę sklep bez programowania

60+
metod SDK
25+
hooków React
42
kontrolerów API
1000+
narzędzi 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}
Interfejsy

Cztery sposoby integracji.

Storefront SDK

Typowany klient TypeScript z ponad 60 metodami i ponad 25 hookami React. Rdzeń bez zależności, opcjonalne powiązania z Reactem.

catalogcartcheckoutauthreviewsreturns

Publiczne REST API

42 kontrolery obejmujące cały katalog, koszyk, zamówienia i klientów. Uwierzytelnianie kluczem API, limity zapytań dla każdego klucza.

RESTOpenAPIrate-limit

Webhooki

Niezawodne webhooki wychodzące z ponawianiem. Reaguj na zamówienia, płatności, uzupełnienia i ruchy magazynowe w czasie rzeczywistym.

order.createdstock.changedretry

Serwer MCP

Oficjalny serwer Model Context Protocol. Połącz Behio z ChatGPT lub Claude i prowadź swój sklep za pomocą 1000 typowanych narzędzi.

MCPChatGPTClaude
W zestawie

Co dostaje programista

Bez kombinowania wokół zamkniętej platformy. Otwarty, typowany interfejs, na którym przyjemnie się buduje.

@behio/storefront-sdk z npm

Instalujesz go jednym poleceniem npm. Rdzeń bez zależności i opcjonalne powiązania z Reactem, licencja MIT, bez uzależnienia od dostawcy.

Typowane API z podpowiedziami

Cały interfejs jest typowany na podstawie OpenAPI, więc edytor podpowiada metody, parametry i kształt odpowiedzi. Błędy wyłapujesz podczas pisania, a nie na produkcji.

Webhooki w czasie rzeczywistym

Reaguj na zamówienia, płatności i ruchy magazynowe. Webhooki wychodzące mają ponawianie, więc żadne zdarzenie Ci nie umknie.

Dokumentacja na sdk.behio.com

Pełna dokumentacja z przykładami, szybkim startem i dedykowanym serwerem MCP. Do tego llms.txt, żeby AI też mogła pomóc Ci w integracji.

API z typem Result

Bez wyjątków. Tylko dane i błąd.

Każde wywołanie zwraca { data, error } z 19 semantycznymi kodami błędów. SDK wie, kiedy warto ponowić próbę (5xx, 429, zerwane połączenie), i odświeża token w tle.

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("Wyprzedane");
7}
Częste pytania

FAQ dla programistów

Czy mogę użyć własnego frontendu?

Tak. Behio jest API-first. Podłącz własny Next.js, Nuxt albo cokolwiek innego przez SDK i publiczne REST API i steruj katalogiem, koszykiem i procesem zamówienia z dowolnego miejsca. Witryna sklepu nie musi być nasza.

Jak wygląda praca lokalna?

Instalujesz SDK, generujesz klucz API i od razu wywołujesz prawdziwe endpointy. Klucze są PUBLIC dla przeglądarki i PRIVATE dla serwera, z limitami zapytań dla każdego klucza, więc testujesz bezpiecznie.

Jak wygląda wersjonowanie?

SDK publikujemy w npm zgodnie z semver, a publiczne API utrzymujemy wstecznie kompatybilne. Zmiany są udokumentowane, więc zawsze wiesz, na czym budujesz.

Szybki start

Od zera do danych w trzech krokach.

01

Zainstaluj SDK

$ npm i @behio/storefront-sdk
02

Zainicjuj klienta

$ behio.init({ apiKey })
03

Pobierz dane

$ await behio.catalog.getProducts()