Cztery kroki do pierwszego modułu

Konto, token API z panelu sklepu, Integracja i moduł. Niżej znajdziesz, jak wygenerować token API i jakie uprawnienia mu nadać. Na start wystarczy token z uprawnieniem tylko do odczytu produktów.

Z takim tokenem Apitizer nie zmieni niczego w Twoim sklepie.

Załóż darmowe konto

Bez karty. W sklepie niczego nie instalujesz.

1

Konto w Apitizerze

Podaj adres e-mail i hasło (co najmniej 8 znaków), a potem wpisz kod, który przyjdzie mailem. Karta nie jest potrzebna. Dane firmy Apitizer poprosi dopiero przy pierwszym płatnym module.

2

Jak wygenerować token API w panelu sklepu

Token to klucz, którym Apitizer łączy się z Twoim sklepem. Utwórz go w panelu sklepu: to Ty decydujesz, do jakich danych daje dostęp.

  1. Zaloguj się do panelu administracyjnego sklepu.
  2. Przejdź do Aplikacje i integracje → Zewnętrzne aplikacje.
  3. Kliknij Dodaj integrację.
  4. W polu Narzędzie wybierz Inne, a w polu Nazwa integracji wpisz np. „Apitizer”.
  5. W sekcji Uprawnienia integracji wybierz Obszar sklepu i Zakres dostępu. Na start wystarczy: produkty, odczyt (zalecane też: kategorie, odczyt). Uprawnienia pod wszystkie moduły: tabela uprawnień. Kolejny obszar dodaj przyciskiem Dodaj uprawnienie.
  6. Zanim utworzysz token, zaloguj się do Apitizera w drugiej karcie przeglądarki i otwórz kreator Integracji. Panel pokaże token tylko raz: jeśli po skopiowaniu tokena skopiujesz kod logowania z maila, token zniknie ze schowka.
  7. Kliknij Zapisz i utwórz token.
  8. Skopiuj Token API od razu: panel pokaże go tylko raz. Client ID nie jest potrzebny. Wklej token w kreatorze Apitizera, w polu Token API, a okno w panelu zamknij przyciskiem Rozumiem.

Jakie uprawnienia nadać tokenowi?

Na start wystarczy odczyt produktów. Prawo zapisu jest potrzebne dopiero modułom, które zmieniają dane w sklepie.

Na start: tokentylko do odczytuSklep → Apitizer: odczytTwój sklepApitizerZapis: brakApitizer nie zmieni niczegow Twoim sklepie.Nowy tokenz prawem zapisuSklep → Apitizer: odczytTwój sklepApitizerApitizer → Sklep: zapisModuły, które zmieniają danew sklepie, zapisują zmiany.
Na start: tokentylko do odczytuSklep → Apitizer: odczytTwój sklepApitizerZapis: brakApitizer nie zmieni niczegow Twoim sklepie.Nowy tokenz prawem zapisuSklep → Apitizer: odczytTwój sklepApitizerApitizer → Sklep: zapisModuły, które zmieniajądane w sklepie,zapisują zmiany.

Na start: tylko odczyt produktów

Do bezpłatnych modułów wystarczy token z uprawnieniem tylko do odczytu, a jedynym wymaganym obszarem są produkty. Zalecany jest też odczyt kategorii, bo bez niego Zdrowie katalogu pominie regułę kategoryzacji. Z takim tokenem Apitizer nie zmieni niczego w Twoim sklepie.

Obszar sklepu

Zakres dostępu

Po co

produkty

odczyt

Zdrowie katalogu sprawdzi karty produktów

kategorie (zalecane)

odczyt

reguła Zdrowia katalogu „Przypisanie do aktywnej kategorii”; bez tego odczytu reguła jest pomijana bez komunikatu w raporcie

Monitor dostępności sprawdza publiczną stronę sklepu. Token przydaje mu się tylko przy przerwie, żeby sprawdzić, czy sklep wyłączono celowo w panelu.

Pod wszystkie moduły od razu

Nadaj te obszary od razu, a przy kolejnym module nie trzeba będzie wracać do panelu sklepu.

Obszar sklepu

Zakres dostępu

Po co

produkty

odczyt + dodawanie + edycja

Zdrowie katalogu czyta; Reguły produktowe, Kolejność produktów i Ceny hurtowe zapisują zmiany w produktach

kategorie

odczyt

warunki reguł; reguła kategorii w Zdrowiu katalogu

producenci

odczyt

warunki reguł

kolekcje

odczyt

warunki i akcje reguł

stany dostępności

odczyt

tylko Reguły produktowe

terminy wysyłki

odczyt

tylko Reguły produktowe

gabaryty produktów

odczyt

tylko Reguły produktowe

promocje

odczyt + dodawanie + edycja + usuwanie

Harmonogram promocji zakłada i zdejmuje promocje; odczyt potrzebny też Cenom hurtowym

Panel nie ma poziomu „odczyt + edycja”, dlatego przy „produkty” wybierz poziom z dodawaniem. Apitizer nie tworzy produktów w sklepie.

Prawo do usuwania jest potrzebne tylko Harmonogramowi promocji: moduł usuwa wyłącznie promocje, które sam założył.

Stany i tagi produktów są w panelu sklepu częścią obszaru „produkty”, więc nie mają osobnego uprawnienia.

3

Integracja w Apitizerze

Kreator Integracji poprosi o dwie rzeczy i przed przejściem dalej sprawdzi połączenie ze sklepem.

Adres techniczny sklepu: adres panelu Shopera, np. sklep123456.shoparena.pl/admin. Wpisz tylko człon przed „.shoparena.pl”, resztę kreator dopisze sam.

Token API: token skopiowany w kroku 2.

W drugim kroku kreatora podaj nazwę sklepu, adres sklepu (Twoją domenę, którą widzą klienci) oraz kontakt do powiadomień.

4

Pierwszy moduł

Na końcu kreatora kliknij „Włącz darmowe Zdrowie katalogu”, a na ekranie aktywacji modułu kliknij „Aktywuj moduł”. W module zaznacz reguły ważne dla Twojego sklepu, np. brak kodu EAN albo zdjęcia głównego, i kliknij „Zapisz reguły”. Gdy Apitizer pobierze katalog, poinformujemy Cię mailowo, a raport przeliczy się przy pierwszym otwarciu.

Przy uruchamianiu modułu Apitizer sprawdzi dostęp tokena do potrzebnych obszarów sklepu. Jeśli czegoś zabraknie, moduł się nie uruchomi, a komunikat wymieni obszary sklepu do dodania. Monitor dostępności uruchamia się bez tej kontroli i zacznie sprawdzać sklep w ciągu około minuty.

Pytania o token API

Czy token trzeba odnawiać?

Nie. Token nie wygasa. Działa, dopóki integracja nie zostanie usunięta w panelu sklepu albo nie zostanie wygenerowany nowy token. Nowy token unieważnia stary, więc wklej go wtedy w ustawieniach Integracji w Apitizerze.

Jak odebrać Apitizerowi dostęp?

Usuń w panelu sklepu (Aplikacje i integracje → Zewnętrzne aplikacje) integrację, w której wygenerowałeś token dla Apitizera. Od tej chwili Apitizer nie ma dostępu do API sklepu. Jeśli działa moduł, który zapisuje w sklepie, najpierw usuń go w Apitizerze: cofnięcie jego zmian wymaga działającego tokena.

Co, jeśli tokenowi zabraknie uprawnień?

Apitizer pokaże to przy uruchamianiu modułu i wymieni brakujące obszary sklepu. Prawa edycji produktów to sprawdzenie nie obejmuje: gdy go zabraknie, pierwsza synchronizacja się zatrzyma, a o problemie z tokenem poinformujemy Cię mailowo. W panelu sklepu, przy integracji, w której wygenerowałeś token dla Apitizera, wybierz Edytuj i dodaj brakujące uprawnienia. Potem wybierz Utwórz nowy Token API, a nowy token wklej w edycji Integracji w Apitizerze i kliknij „Sprawdź i zapisz token”. Nowy token unieważni stary.

Co Apitizer robi z tokenem?

Przechowuje go zaszyfrowany i po zapisaniu nie pokazuje nikomu: pole tokena w edycji Integracji jest zawsze puste. „Pokaż token” w kreatorze odsłania tylko wartość, która jest właśnie wpisywana. Więcej: bezpieczeństwo tokena i danych.

Kto pomoże, jeśli coś nie zadziała?

Napisz w Pomocy po zalogowaniu, a odpowie człowiek, w dni robocze w godzinach 8–16. Przy błędnym adresie albo tokenie kreator Integracji podpowie, co sprawdzić. Pomoc techniczna platformy sklepu nie obsługuje połączeń przez API, więc pytania o Integrację kieruj do Apitizera.

Start od bezpłatnych modułów

Konto, token tylko do odczytu produktów i Zdrowie katalogu. Moduły, które zmieniają dane w sklepie, można dodać później.

Załóż darmowe konto

Bez karty. Bezpłatne moduły bez limitu czasu.