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
-
OpenAPI 3.1.0 (JSON): https://bhpb.shop/openapi.json – kompletny, typowany schemat API z unikalnymi
operationId, parametrami i modelami odpowiedzi. - Specyfikacja OpenAPI (YAML): https://bhpb.shop/api/openapi.yaml
- Manifest Agenta (llms.txt): https://bhpb.shop/llms.txt – ustrukturyzowane wytyczne i instrukcje dla modeli LLM.
- Pełne instrukcje agenta: https://bhpb.shop/agents.md
- Universal Commerce Protocol (UCP): https://bhpb.shop/.well-known/ucp
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 parametrylimit(1–250) orazpage. -
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.