Generowanie tokena API dla integracji zewnętrznej
WAŻNE! Łączenie się ze sklepem po API nie jest wspierane przez obsługę techniczną Shoper. Wszelkie informacje w tym temacie znajdują się na stronie: App Store – create your own apps.
Dzięki temu rozwiązaniu samodzielnie z poziomu panelu administracyjnego sklepu Shoper wygenerujesz tokeny API, pozwalające na budowanie niestandardowych integracji z zewnętrznymi rozwiązaniami.
Jak wygenerować token API w panelu Shoper?
Wcześniejsze integracje API działające w oparciu o login i hasło pozostają aktualne, aczkolwiek w przypadku tworzenia nowych połączeń sugerujemy korzystanie z mechanizmu generowania tokena API.
Narzędzie (A) – wybierz z predefiniowanej listy narzędzie, które chcesz zintegrować. Jeśli narzędzie nie jest widoczne na liście wybierz: Other. Na liście znajdują się następujące pozycje:
- Baselinker
- LEO Synchronizator
- RestSharp
- Embarcadero
- IVend
- CTI
- IdeaERP
- Zabbix
- Salesmanago
- XSale
- Sellasist
- Other
Nazwa integracji (B) – podaj nazwę, która będzie widoczna na liście wszystkich integracji zewnętrznych
Opis (C) – możesz podać szerszy opis integracji
Uprawnienia integracji > Obszar sklepu (D) – wybierz z listy obiekt, dla którego chcesz udzielić dostępu po API. Na liście znajdują się następujące pozycje:
- Pola dodatkowe formularzy
- Stany dostępności
- Kategorie
- Kolekcje
- Produkty
- Producenci
- Strony informacyjne
- Administratorzy
- Blokada aplikacji
- Atrybuty produktów
- Aukcje
- Dane rozliczeniowe
- Waluty
- Pulpit
- Terminy wysyłki
- Gabaryty produktów
- Języki i lokalizacja
- Aktualności
- Warianty produktów
- Zamówienia
- Przesyłki
- Płatności
- Postępy
- Przekierowania
- Dostawy
- Promocje
- Statusy zamówień
- Subskrybenci
- Stawki vat
- Jednostki miar
- Klienci
- Magazyny
- Webhooki
- Strefy dostaw
- Kupony rabatowe
Obszar sklepu, do którego integracja ma uzyskać dostęp, określany jest przez twórcę integracji.
Uprawnienia integracji > Zakres dostępu (E) – wybierz zakres akcji, jakie mogą być wykonywane w wybranym wcześniej obszarze (D).
- Odczyt
- Odczyt+dodawanie
- Odczyt+dodawanie+edycja
- Odczyt+dodawanie+edycja+usuwanie
Możesz dodać kolejne uprawnienia (F), dla kolejnych obszarów. Pojawi się także możliwość usunięcia dodanych uprawnień.
Po wprowadzeniu wszystkich danych w formularzu kliknij: ZAPISZ I UTWÓRZ TOKEN (G).
Skopiuj wygenerowany Token API, a następnie wprowadź go w odpowiednim miejscu w zewnętrznym panelu narzędzia, które chcesz zintegrować z oprogramowaniem Shoper.
Skopiuj Token API przed zamknięciem tej strony.
Token API to najważniejsze zabezpieczenie Twojej integracji. Możesz go skopiować tylko teraz. Nie przekazuj go osobom trzecim ani nie przechowuj. W razie problemu możesz utworzyć nowy token.
Kliknij: ROZUMIEM (B), aby zamknąć okno.
Po ikoną koła zębatego przy danej integracji zobaczysz następujące opcje:
- Edytuj – możesz zmienić nazwę aplikacji, jej opis lub uprawnienia
- Utwórz nowy Token API – jeśli utworzony wcześniej token nie został skopiowany, możesz utworzyć nowy token dla danej integracji
- Usuń – możesz usunąć integrację
Raz wygenerowany token nie traci ważności i nie wygasa. Jeśli z jakiegoś powodu utracisz token lub integracja przestanie działać, możesz wygenerować nowy token według poniższej instrukcji.
Jak wygenerować nowy token API dla integracji zewnętrznej?
Dotychczasowy token zostanie unieważniony, a integracja przestanie działać. Aby przywrócić działanie, skopiuj nowo utworzony token i zmień na nowy w zewnętrznym panelu narzędzia.
Warto zapamiętać!
- Jak wygenerować Token API dla integracji z oprogramowaniem Shoper?
- Jak wygenerować nowy Token API dla istniejącej integracji?