API PrestaShop to zestaw interfejsów, przez które zewnętrzne systemy — ERP, magazyny, marketplace'y, linkery, aplikacje mobilne — komunikują się ze sklepem bez dotykania panelu administracyjnego. Bez API nie ma automatyzacji: stany magazynowe nie zsynchronizują się z Allegro, faktury nie popłyną do księgowości, a zamówienia z marketplace'ów będą wprowadzane ręcznie. PrestaShop daje dziś dwa światy API: klasyczny Webservice (CRUD, klucz API) dostępny od zawsze oraz nowe Admin API (OAuth, CQRS) rozwijane od wersji 9. Integracja przez API kosztuje zwykle 2 000–12 000 zł netto, zależnie od liczby systemów i złożoności mapowania danych.
Najważniejsze: PrestaShop API to dwa interfejsy: klasyczny Webservice API (CRUD na zasobach: products, orders, customers, stock_availables — z kluczem API i uprawnieniami) oraz nowe Admin API (OAuth, endpointy CQRS, rozwijane od PrestaShop 9). Typowe integracje: Baselinker i marketplace'y (Allegro, Amazon), ERP i magazyny (Subiekt, Comarch, WMS), kurierzy i płatności, BI i hurtownie danych. Koszt integracji: 2 000–12 000 zł netto. Zasady bezpieczeństwa: minimalne uprawnienia klucza, HTTPS, whitelist IP, logowanie i monitoring.
Webservice API — klasyka, która wciąż napędza integracje
Klasyczny Webservice PrestaShop to REST-owe CRUD na zasobach sklepu. Działa w każdej wersji i obsługuje niemal wszystkie typowe integracje.
- Zasoby —
products,categories,combinations,stock_availables,orders,customers,carts,invoices,manufacturers,suppliersi dziesiątki innych. - Autoryzacja — klucz API tworzony w panelu (Zaawansowane > Webservice), z granularnymi uprawnieniami per zasób (GET/POST/PUT/DELETE) — nadawaj tylko to, czego potrzebuje integracja.
- Format — XML domyślnie, JSON przy dopisaniu
?output_format=JSON(albo przez nagłówek). - Zastosowania — importy i aktualizacje produktów i stanów, pobieranie zamówień do ERP, synchronizacja klientów, generowanie faktur, integracje z linkerami sprzedaży.
Ograniczenia klasycznego Webservice: brak nowoczesnego uwierzytelniania, XML-owa „uroda", wydajność przy hurtowych operacjach (dziesiątki tysięcy produktów wymagają importów partiami, poza godzinami szczytu) oraz brak zdarzeń — to klient musi pytać (polling), chyba że zbudujesz webhooki po stronie sklepu.
Admin API — nowa generacja (PrestaShop 9+)
Od PrestaShop 9 rozwijane jest Admin API: uwierzytelnianie OAuth, endpointy w stylu CQRS, podejście bardziej domenowe. To fundament pod nowoczesne integracje i headless commerce.
-
OAuth zamiast kluczy — standard branżowy, lepszy dla integracji SaaS.
-
Endpointy domenowe — operacje opisane językiem procesów (zamówienia, produkty), nie surowe tabele.
-
Rozwój równoległy — klasyczne Webservice pozostaje wspierane; nowe projekty warto planować z myślą o Admin API, ale decyzja zależy od tego, co obsługuje system po drugiej stronie.
-
Praktyczna uwaga: ekosystem integracji (Baselinker, ERP, moduły) wciąż w dużej części opiera się na klasycznym Webservice — przed projektem sprawdź, co realnie wspiera twój partner.
Typowe integracje przez API PrestaShop
| Integracja | Kierunek danych | Kluczowe wyzwania |
|---|---|---|
| Baselinker / linkery | Zamówienia ↔ sklep, stany ← magazyn | Mapowanie statusów, duplikaty zamówień |
| Allegro / marketplace'y | Oferty, stany, ceny, zamówienia | Limity API marketplace'u, overselling |
| ERP (Subiekt, Comarch) | Produkty, stany, zamówienia, faktury | Mapowanie pól, jednostki miary, VAT |
| WMS / magazyn | Stany, rezerwacje, wysyłki | Czas rzeczywisty, konflikty stanów |
| Kurierzy i płatności | Etykiety, statusy, zwroty | Webhooki, idempotencja |
| BI / raportowanie | Sprzedaż, koszyki, produkty | Obciążenie bazy — czytaj z repliki lub eksportów |
O budowie odpornych integracji (kolejki, retry, idempotencja, monitoring) piszę w artykule integracje API i webhooki — odporne procesy, a o łączeniu sprzedaży w jeden hub — w przewodniku automatyzacja sprzedaży przez API i Baselinker.
Bezpieczeństwo API — zasady, których nie wolno pominąć
- Minimalne uprawnienia — osobny klucz per integracja, tylko potrzebne zasoby i metody. Klucz „na wszystko" to zaproszenie do katastrofy.
- HTTPS i whitelist IP — Webservice powinien być dostępny wyłącznie po HTTPS, najlepiej z ograniczeniem adresów IP partnera.
- Nie loguj danych osobowych — logi integracji nie mogą zawierać pełnych danych klientów; maskuj i retencjonuj zgodnie z RODO.
- Monitoring i alerty — brak synchronizacji stanów przez kilka godzin to potencjalny overselling i reklamacje; integracja musi mieć monitoring i alerty.
- Aktualizacje i testy — po każdej aktualizacji PrestaShop i modułów przetestuj kluczowe przepływy API; zmiany w rdzeniu potrafią zmienić zachowanie zasobów.
Ile kosztuje integracja przez API PrestaShop?
| Zakres | Cena (netto) |
|---|---|
| Prosta integracja (jedno źródło → sklep, np. stany) | 2 000–4 000 zł |
| Integracja dwukierunkowa (marketplace, ERP) | 4 000–8 000 zł |
| Złożony hub (kilka systemów, kolejki, monitoring) | 8 000–20 000 zł+ |
| Utrzymanie integracji | od 300 zł/mies. |
Przy planowaniu warto pamiętać, że koszt to nie tylko kod: mapowanie danych, testy na realnych wolumenach i utrzymanie po zmianach API po obu stronach. Jeśli integracji jest kilka, taniej wychodzi jeden hub (linker) niż trzy osobne łączniki — analizę robimy przed wyceną.
Najczęściej zadawane pytania
Jak włączyć Webservice API w PrestaShop?
- W panelu: Zaawansowane > Webservice, dodaj klucz, nadaj uprawnienia per zasób (np. tylko odczyt zamówień i zapis stanów), ustaw whitelist IP. Adres API to
/api/twojej domeny. Klucz traktuj jak hasło — trzymaj w menedżerze sekretów, nie w kodzie.
Czy PrestaShop 9 ma nowe API?
Tak — PrestaShop 9 rozwija Admin API z OAuth i endpointami CQRS. Klasyczny Webservice pozostaje wspierany, więc istniejące integracje działają dalej; nowe projekty warto konsultować z partnerem co do docelowego interfejsu.
Jak zsynchronizować stany magazynowe z Allegro?
Przez API PrestaShop (odczyt stanów) i API Allegro (aktualizacja ofert) — bezpośrednio albo przez linker typu Baselinker. Kluczowe: częstotliwość synchronizacji, obsługa rezerwacji i ochrona przed oversellingiem. Praktyczny przewodnik: Allegro + PrestaShop.
Czy API PrestaShop jest bezpieczne?
Mechanizm kluczy z uprawnieniami jest wystarczający, jeśli przestrzega się zasad: minimalne uprawnienia, HTTPS, whitelist IP, osobne klucze per integracja, rotacja i monitoring. Największe ryzyka to wyciek klucza z kodu i nadmierne uprawnienia.
Ile produktów można zsynchronizować przez API?
Dziesiątki tysięcy — ale hurtowe operacje trzeba prowadzić partiami, z throttlingiem i poza godzinami szczytu. Klasyczny Webservice nie lubi masowych zapisów w trakcie ruchu; przy dużych katalogach planujemy importy przyrostowe i kolejkowanie.
Czy integrację API można napisać samemu?
Proste przepływy (eksport zamówień, aktualizacja stanów) są w zasięgu ogarniętego zespołu. Integracje krytyczne dla sprzedaży — z idempotencją, retry, monitoringiem i obsługą błędów — lepiej powierzyć wykonawcy z doświadczeniem: awaria synchronizacji kosztuje więcej niż jej napisanie.
Źródła i narzędzia
- PrestaShop DevDocs — Webservice API
- PrestaShop DevDocs — Admin API
- PrestaShop DevDocs — dokumentacja deweloperska
- Baselinker — dokumentacja integracji
- OWASP — bezpieczeństwo API
👉 Potrzebujesz integracji sklepu z ERP, marketplace lub kurierami? Zobacz, jak wygląda integracje e-commerce w mojej ofercie: API PrestaShop, webhooki, kolejki, monitoring i utrzymanie integracji. Napisz przez formularz kontaktowy lub na kontakt@informatix.com.pl.
👉 Automatyzujesz sprzedaż? Sprawdź artykuły automatyzacja sprzedaży przez API i Baselinker, integracje API i webhooki i Allegro + PrestaShop.
📖 Zobacz również: PrestaShop developer, wdrożenia PrestaShop, wycena aplikacji webowej — ile kosztuje w 2026? oraz projektowanie sklepów internetowych.