Developers & API

Portal Deweloperski i Dokumentacja API BHPB

Witaj w portalu deweloperskim BHPB (Baggy Pants for Snowboarding). Sklep bhpb.shop oferuje otwarty, ustandaryzowany dostęp maszynowy dla autonomicznych agentów AI (np. Claude Code, Cursor, Ora), porównywarek e-commerce oraz zewnętrznych deweloperów.

1. Specyfikacja OpenAPI & Manifesty Agentów

2. Publiczne Endpointy Storefront REST API

Dostęp do katalogu produktów jest w pełni publiczny (darmowy tier, bez konieczności rejestracji czy generowania kluczy):

  • GET /products.json – Lista wszystkich opublikowanych produktów z cenami, wariantami, opcjami i stanami magazynowymi. Obsługuje parametry limit (1–250) oraz page.
  • GET /products/{handle}.json – Szczegóły konkretnego modelu (np. illuminati, gsou-snow, pinky, orbit).
  • GET /collections.json – Lista kolekcji sklepu.
  • GET /collections/{handle}/products.json – Produkty w wybranej kolekcji.

3. Uwierzytelnianie & Uprawnienia (OAuth 2.0 / Scopes)

Zgodnie z RFC 9728 oraz standardami OpenAPI, operacje maszynowe operują na zdefiniowanych zakresach uprawnień:

  • products:read – Publiczny odczyt katalogu, opisów technicznych i cen (nie wymaga tokenu).
  • cart:write – Tworzenie i aktualizacja koszyka w imieniu użytkownika za pośrednictwem Storefront API lub Universal Commerce Protocol.

4. Środowisko Testowe (Sandbox) & Szybki Start

Do testowania integracji bez obciążania środowiska produkcyjnego udostępniamy darmowy mock API: https://mock.shop.

5. Integracja MCP (Model Context Protocol)

Endpoint serwera MCP dostępny jest pod adresem https://bhpb.shop/api/ucp/mcp. Umożliwia wyszukiwanie produktów w katalogu, zarządzanie koszykiem oraz asystę zakupową za zgodą użytkownika.