API bol to fundament techniczne, które umożliwia sprzedawcom automatyzację procesów biznesowych na bol.com. Niezależnie od tego, czy chcesz zarządzać zamówieniami, cennami, czy prowadzić kampanie reklamowe - API bol umożliwia programistyczne zarządzanie wszystkim bez konieczności ręcznego przeglądania portalu sprzedaży. W tym artykule wyjaśniamy, jak działa API bol, jakie są dostępne punkty końcowe, jak zacząć i kiedy lepiej wybrać gotową integrację.
Co to jest API bol i dlaczego jest ważne?
API oznacza Interfejs Programowania Aplikacji - techniczny interfejs, który umożliwia komunikację między systemami oprogramowania. API bol pozwala sprzedawcom na połączenie własnego oprogramowania lub narzędzi osób trzecich z platformą bol.com. Oznacza to, że możesz całkowicie zautomatyzować procesy, takie jak zarządzanie zamówieniami, aktualizacje stanu magazynowego, zmiany cen i potwierdzenia wysyłki.
Dla sprzedawców z więcej niż 50 produktami lub wieloma kanałami sprzedaży API bol jest prawie niezbędne. Ręczna praca za pośrednictwem panelu sprzedawcy (SDD) jest czasochłonna i podatna na błędy. Z połączeniem API oszczędzasz nie tylko godziny tygodniowo, ale także minimalizujesz błędy, które mogą prowadzić do słabych wyników.
Od API Plaza do API Retailer
Bol.com całkowicie zastąpił stare API Plaza nowocześniejszym API Retailer. API Plaza nie jest już obsługiwane, a nowe połączenia są możliwe tylko za pośrednictwem API Retailer. Oferuje on lepsze wyniki, więcej punktów końcowych, poprawioną bezpieczeństwo i bardziej szczegółową dokumentację. Jeśli nadal używasz starego połączenia Plaza, jest niezwykle ważne, aby jak najszybciej je przenieść.
Trzy API bol.com wyjaśnione
Bol.com oferuje trzy oddzielne API, które łącznie pokrywają pełny zakres funkcjonalności sprzedawcy. Każe API ma swój własny cel i zestaw punktów końcowych.
| API | Główna funkcja | Najważniejsze punkty końcowe | Przeznaczone dla |
|---|---|---|---|
| API Retailer | Pełne zarządzanie zamówieniami i produktem | Zamówienia, Wysyłki, Zwroty, Oferty, Stan magazynowy, Prowizja | Wszyscy sprzedawcy |
| API Oferta | Zarządzanie ofertą i ceną | Oferty (CRUD), Cennik, Aktualizacje stanu magazynowego, Zawartość produktu | Sprzedawcy z dużymi katalogami |
| API Reklamodawcy | Kampanie reklamowe i raportowanie | Kampanie, Grupy reklamowe, Słowa kluczowe, Raporty wydajności | Sprzedawcy z budżetem reklamowym |
API Retailer bol
API Retailer to najbardziej zaawansowane i najczęściej używane API bol.com. Za jego pomocą możesz zautomatyzować prawie wszystkie procesy sprzedaży: od pobierania nowych zamówień i potwierdzania wysyłek po przetwarzanie zwrotów i pobieranie podsumowań prowizji. API Retailer obsługuje również zarządzanie Twoją ofertą, aktualizację poziomów magazynowych i pobieranie raportów wydajności.
API Oferta bol
API Oferta koncentruje się specjalnie na zarządzaniu Twoją ofertą. Możesz za jego pomocą przesłać nowe produkty, zmodyfikować istniejące oferty, zmienić ceny i zaktualizować poziomy magazynowe. Dla sprzedawców z setkami lub tysiącami produktów ten API jest niezwykle ważny, aby ceny i magazyn były w czasie rzeczywistym zsynchronizowane z Twoim systemem ERP lub WMS.
API Reklamodawcy bol
Za pomocą API Reklamodawcy automatyzujesz swoje kampanie Sponsored Products. Możesz tworzyć kampanie, zarządzać grupami reklamowymi, modyfikować oferty i pobierać szczegółowe raporty wydajności - w tym wyświetlenia, kliknięcia, konwersje i ACoS (Koszt Reklamy Sprzedaży). Jest to szczególnie cenne, jeśli prowadzisz wiele kampanii jednocześnie i chcesz je szybko zoptymalizować na podstawie danych.
Najważniejsze punkty końcowe i funkcjonalności
API Boloo oferuje dziesiątki endpointów. Poniżej znajdziesz przegląd najczęściej używanych endpointów w każdej kategorii, abyś mógł szybko ocenić, które są Ci potrzebne.
| Kategoria | Endpoint | Metoda | Opis |
|---|---|---|---|
| Zamówienia | /orders | GET | Pobierz wszystkie otwarte zamówienia |
| Zamówienia | /orders/{orderId} | GET | Wyświetl szczegóły konkretnego zamówienia |
| Wysyłka | /orders/{orderId}/shipment | PUT | Potwierdź wysyłkę z śledzeniem |
| Reklamacje | /returns | GET | Pobierz otwarte reklamacje |
| Reklamacje | /returns/{returnId} | PUT | Rozpatrz reklamację (zaakceptuj/odrzuć) |
| Oferty | /offers | POST | Utwórz nową ofertę produktu |
| Oferty | /offers/{offerId} | PUT | Zmień cenę, stan lub stan produktu |
| Stan magazynowy | /offers/{offerId}/stock | PUT | Aktualizuj poziom stanu magazynowego |
| Prowizja | /commission | GET | Pobierz procenty prowizji dla każdej kategorii |
| Analiza | /insights/performance | GET | Pobierz wyniki i wskaźniki KPI |
Autoryzacja i bezpieczeństwo
API Boloo używa OAuth 2.0 do autoryzacji. Oznacza to, że najpierw musisz utworzyć poświadczenia API (Client ID i Client Secret) w swoim koncie sprzedaży na bol.com. Następnie użyjesz tych poświadczeń, aby uzyskać tymczasowy token dostępu, który będziesz musiał dołączyć do każdego wywołania API.
Krok po kroku ustawienie autoryzacji
- Zaloguj się do portalu partnera - Przejdź do swojego konta sprzedaży na bol.com partner login i przejdź do Ustawienia > Ustawienia API
- Utwórz poświadczenia API - Kliknij „Utwórz nowe poświadczenia API” i zapisz swoje Client ID i Client Secret w bezpiecznym miejscu
- Poproś o token dostępu - Wyślij żądanie POST do punktu końcowego tokena z Twoimi poświadczeniami (zakodowanymi w Base64), aby otrzymać token nośnika
- Użyj tokenu - Dołącz token do nagłówka Autoryzacji w każdym wywołaniu API
- Odśwież token - Tokeny dostępu wygasają po określonym czasie; zaimplementuj automatyczne odświeżanie tokenu w swojej aplikacji
Nigdy nie przechowuj swoich poświadczeń API w publicznych repozytoriach kodu lub udostępnionych dokumentach. Używaj zmiennych środowiskowych lub menedżera tajemnic. W przypadku podejrzenia wycieku możesz odwołać swoje poświadczenia bezpośrednio za pośrednictwem portalu partnera.
Limity szybkości i najlepsze praktyki
Bol.com stosuje surowe limity szybkości, aby chronić serwery API. Jeśli wysyłasz zbyt wiele żądań w krótkim czasie, otrzymasz błąd HTTP 429 (Too Many Requests). Ważne jest, aby Twoja aplikacja była zaprojektowana w taki sposób, aby respektowała limity szybkości.
| Aspekt | Limity | Zalecenie |
|---|---|---|
| Żądania na minutę | Zmienny dla każdego punktu końcowego | Zaimplementuj wykładnicze cofanie przy błędach 429 |
| Operacje partii | Maks. 1 000 elementów na partię | Podziel duże aktualizacje na mniejsze partie |
| Ważność tokenu | Ograniczony czas życia | Buforuj tokeny i odświeżaj je proaktywnie przed wygaśnięciem |
| Dzienna limit | Zależy od typu konta | Monitoruj swoje użycie API za pośrednictwem portalu partnera |
| Żądania współbieżne | Ograniczona liczba jednoczesnych | Używaj kolejki żądań z ograniczeniem przepustowości |
Najlepsze praktyki korzystania z API
- Użyj webhooks - Zamiast ciągłego pollowania nowych zamówień, ustaw webhooks, aby serwer bol.com powiadomił Cię o zmianach
- Wdrożenie logiki retry - W przypadku tymczasowych błędów (kody statusu 5xx) ponów próbę z wykładniczym wycofaniem
- Buforuj odpowiedzi - Zapisz często wykorzystywane dane (takie jak procenty prowizji) lokalnie, aby uniknąć niepotrzebnych wywołań API
- Rejestruj wszystkie wywołania API - Prowadź szczegółowy dziennik do debugowania i monitorowania Twojego użycia API
- Waliduj dane wejściowe - Sprawdź dane przed wysłaniem ich do API, aby uniknąć niepotrzebnych komunikatów o błędach
Samodzielne budowanie vs. gotowa integracja
Jedną z najważniejszych decyzji dla sprzedawców jest to, czy zbudować oprogramowanie na API bol, czy użyć istniejącego narzędzia. Oba rozwiązania mają wady i zalety, które silnie zależą od Twojej wiedzy technicznej, budżetu i skali.
| Kryterium | Samodzielne budowanie | Gotowe narzędzie |
|---|---|---|
| Koszty początkowe | 5 000–15 000+ € (czas rozwoju) | 0–50 €/miesiąc |
| Czas trwania | 2–6 miesięcy | Dostępne od razu |
| Utrzymanie | Ciągłe potrzebne (aktualizacje API) | Wliczone w cenę przez dostawcę |
| Elastyczność | Pełna możliwość dostosowania | Ograniczona do oferowanych funkcji |
| Ryzyko | Wysokie (zależność od programisty) | Niskie (udowodniona platforma) |
| Skalowalność | Zależy od architektury | Zazwyczaj dobrze skalowalna |
| Wsparcie | Własna odpowiedzialność | Dostępna pomoc techniczna i dokumentacja |
| Aktualizacje API | Własna implementacja | Automatycznie aktualizowane |
Kiedy samodzielne budowanie ma sens
Samodzielne budowanie ma sens tylko wtedy, gdy masz bardzo specyficzną pracę, której nie obsługuje żadne istniejące narzędzie, dysponujesz dedykowanym zespołem programistów, które może długoterminowo utrzymywać połączenie, i jesteś gotów ponieść koszty utrzymania i aktualizacji API. W praktyce dotyczy to mniej niż 5% sprzedawców.
Dlaczego większość sprzedawców wybiera narzędzie
Dla ogromnej większości sprzedawców gotowe narzędzie jest najrozsądniejszym wyborem. Narzędzia takie jak Boloo oferują obszerną integrację z API bol bez konieczności samodzielnego programowania. Zyskujesz dostęp do funkcji takich jak śledzenie produktów, eksplorator słów kluczowych, panel sprzedaży i automatyczne fakturowanie - wszystko zbudowane na oficjalnym API bol.
Częste błędy podczas pracy z API bol
Wielu sprzedawców i programistów popełnia te same błędy, gdy po raz pierwszy pracują z API bol. Poznanie ich może Ci oszczędzić cenny czas i pieniądze.
- Nie implementuj obsługi błędów - API może być czasowo niedostępne lub zwracać nieoczekiwane odpowiedzi. Bez dobrej obsługi błędów cały system może ulec awarii
- Ignoruj limity szybkości - Wysyłanie zbyt wielu żądań w krótkim czasie prowadzi do zablokowania. Zawsze implementuj throttling i wykładnicze cofanie
- Wpisuj poświadczenia bezpośrednio w kod - Umieszczanie kluczy API w kodzie źródłowym jest poważnym ryzykiem bezpieczeństwa. Zawsze używaj zmiennych środowiskowych
- Nie testuj w środowisku testowym - Bol.com oferuje środowisko testowe. Użyj go, aby przetestować swoją integrację przed przejściem na produkcję
- Postępuj zgodnie ze starej dokumentacji - API jest regularnie aktualizowane. Zawsze odwiedzaj oficjalną dokumentację na portalu deweloperskim bol.com
- Nie ustaw monitorowania - Bez monitorowania dowiesz się o problemach dopiero wtedy, gdy klienci zaczną skarżyć. Ustaw alerty dla błędów i opóźnień
Jak Boloo wykorzystuje API bol optymalnie
Boloo jest w pełni zbudowane na oficjalnym API bol i oferuje sprzedawcom przyjazny interfejs ponad techniczną złożonością. Gdzie z surowym API musisz samodzielnie wywoływać punkty końcowe i przetwarzać dane, Boloo robi to automatycznie w tle.
- Product Tracker - Monitoruj konkurentów i zmiany cen za pomocą API detalicznego
- Product Database - Przeglądaj cały asortyment bol.com z zaawansowanymi filtrami
- Keyword Verkenner - Analizuj objętości wyszukiwania i trendy za pomocą danych API
- Ranking Checker - Śledź swoją pozycję w wynikach wyszukiwania automatycznie
- Listing Generator AI - Optymalizuj swoje strony produktowe na podstawie wglądu API
- Sales Dashboard - Dane sprzedaży i zamówień w czasie rzeczywistym za pomocą API detalicznego
- Winstcalculator - Liczy marże, w tym bieżące stawki prowizyjne
- Automatische Facturatie - Generuje faktury automatycznie przy nowych zamówieniach
- E-mail Campagnes - Wysyłaj ukierunkowane kampanie na podstawie danych klientów
- LVB Box Size Checker - Optymalizuj koszty wysyłki z odpowiednimi rozmiarami pudełek
Korzyść z korzystania z narzędzia takiego jak Boloo polega na tym, że możesz skorzystać ze wszystkich możliwości API bol bez konieczności posiadania wiedzy technicznej. Aktualizacje API są automatycznie przetwarzane, a Ty możesz od razu zacząć optymalizować swoją sprzedaż.
Często zadawane pytania o API bol
Gdzie znajdę oficjalną dokumentację API bol?
Oficjalna dokumentacja jest dostępna na portalu deweloperskim bol.com. Znajdziesz tam szczegółowe opisy wszystkich punktów końcowych, przykładowy kod, środowisko testowe i dzienniki zmian z najnowszymi aktualizacjami. Dokumentacja jest regularnie aktualizowana przy nowych wydaniach.
Jaka jest różnica między API detalicznym a starym API Plaza?
API Plaza zostało całkowicie wycofane i nie jest już obsługiwane. API detaliczne jest następcą z lepszymi wynikami, większą ilością punktów końcowych, ulepszoną autentykacją OAuth 2.0 i rozszerzoną funkcjonalnością. Wszystkie nowe połączenia muszą być budowane za pomocą API detalicznego. Istniejące połączenia Plaza nie działają już.
Czy potrzebuję wiedzy programistycznej, aby korzystać z API bol?
Aby od razu zacząć korzystać z API, potrzebujesz wiedzy programistycznej w języku takim jak Python, PHP, JavaScript lub C#. Nie masz doświadczenia technicznego? Wtedy lepiej wybrać gotowe narzędzie, takie jak Boloo, które zajmuje się integracją z API bez konieczności pisania kodu przez Ciebie.
Czy korzystanie z API bol.com wiąże się z kosztami?
Samodzielne korzystanie z API bol.com jest bezpłatne. Nie płacisz dodatkowych opłat za wywołania API. Koszty tkwią w tworzeniu i utrzymaniu własnego oprogramowania lub w subskrypcji narzędzia, które wykorzystuje API. Bol.com nalicza tylko standardową prowizję za sprzedaż.
Jak często API bol.com jest aktualizowane?
Bol.com regularnie aktualizuje API o nowe punkty końcowe, ulepszoną funkcjonalność i łaty bezpieczeństwa. Duże aktualizacje są wcześniej ogłaszane za pośrednictwem portalu dla deweloperów z okresem migracji. Ważne jest, aby śledzić te zmiany, jeśli samodzielnie utrzymujesz połączenie - w przypadku gotowych narzędzi jest to obsługiwane automatycznie.
Czy mogę używać API bol.com dla wielu kont sprzedaży?
Tak, możesz używać API dla wielu kont sprzedaży. Każde konto ma własne poświadczenia API. Narzędzia takie jak Boloo obsługują zarządzanie wieloma kontami z poziomu jednego panelu, co znacznie upraszcza przegląd dla sprzedawców z wieloma markami lub sklepami.
Zacznij za darmo z Boloo
Użyj narzędzi Boloo, aby sprzedawać mądrzej na bol.com. Wypróbuj za darmo.
Wypróbuj Boloo za darmo
