Eshop Quickstart
Z BizKitHub Docs, znalostní báze platformy
Tento průvodce vás provede nejmenším možným headless e-shopem postaveným na základě BizKitHub. Backend (produkty, košík, objednávky, platby) se nachází uvnitř BizKitHub; frontend je aplikace Next.js, která získává data z veřejného REST API.
Přehled
Tento průvodce vás provede nejmenším možným headless e-shopem postaveným na základě BizKitHub. Backend (produkty, košík, objednávky, platby) se nachází uvnitř BizKitHub; frontend je aplikace Next.js, která získává data z veřejného REST API.
Předpoklady
- Organizace BizKitHub s přístupem k API.
- Základní znalosti JavaScriptu nebo TypeScriptu.
- Znalost REST API.
- Nainstalovaný Node.js lokálně.
1. Získejte své API údaje
Vytvořte API klíč v administračním panelu. Používejte klíč DEV_ během vývoje, poté přepněte na klíč PROD pro nasazenou aplikaci.
BIZKITHUB_API_KEY=DEV_xxxxxxxxxxxxxxxxxxxxxxxxxxx
BIZKITHUB_API_URL=https://api.bizkithub.com/api/v1
2. Nastavte projekt
npx create-next-app@latest my-eshop
cd my-eshop
Uložte API klíč a základní URL do souboru .env.local a přidejte tento soubor do .gitignore.
3. Vytvořte API klienta
Malý serverový pomocník udržuje API klíč mimo balíček prohlížeče.
// lib/bizkithub.ts
const API_KEY = process.env.BIZKITHUB_API_KEY!;
const API_URL = process.env.BIZKITHUB_API_URL!;
export async function fetchFromAPI(path: string, init: RequestInit = {}) {
const url = new URL(`${API_URL}${path}`);
url.searchParams.set('apiKey', API_KEY);
const response = await fetch(url, {
...init,
headers: { 'Content-Type': 'application/json', ...init.headers },
});
if (!response.ok) throw new Error(`API error ${response.status}`);
return response.json();
}
4. Získejte a zobrazení produkty
// app/products/page.tsx
import { fetchFromAPI } from '@/lib/bizkithub';
export default async function ProductsPage() {
const { items } = await fetchFromAPI('/product/list');
return (
<ul>
{items.map((p) => (
<li key={p.id}>{p.name} — {p.price} {p.currency}</li>
))}
</ul>
);
}
5. Vytvořte objednávku
Obsah košíku a identifikátor zákazníka jsou odeslány na endpoint objednávek; odpověď obsahuje hash objednávky, který odemkne veřejnou stránku objednávky a platební bránu.
const order = await fetchFromAPI('/order/create', {
method: 'POST',
body: JSON.stringify({
items: [{ productId: 'prod_abc', quantity: 1 }],
customer: { email: '[email protected]' },
}),
});
window.location.href = order.paymentUrl;
6. Zpracování zpětného volání platby
BizKitHub odesílá podepsaný webhook na vaši nakonfigurovanou URL, když se platba provede. Ověřte podpis a poté označte místní objednávku jako zaplacenou nebo aktivujte dodávkový proces.
Kam dál
- Odkaz na katalog produktů —
/api/v1/product. - Košík a cenové pravidla —
/api/v1/cart. - Platební brány a opakované tokeny —
/api/v1/payment. - Formát podpisu webhooku —
/api/v1/webhook.
Související
Stránka byla naposledy upravena 26. července 2026.