Masowy import przekierowań 301 do sklepu za pośrednictwem API
Przygotowanie narzędzi pomocnych do tworzenia przekierowań 301 dla sklepów na platformie Shoper
Postman to darmowa aplikacja, która pozwala testować API. Narzędzie jest na tyle intuicyjne, że bez problemu mogą z niego korzystać osoby z podstawową wiedzą programistyczną. Aplikację można pobrać na stronie: Zarejestruj się i pobierz Postman.
Import gotowego środowiska
Stworzyliśmy gotowe środowisko Shoper Environment, dzięki któremu w łatwy sposób wykorzystasz zmienne środowiskowe, potrzebne do łatwiejszej autoryzacji połączenia ze sklepem. Pobierz plik ze środowiskiem.


Import kolekcji i generowanie tokena
Token to klucz niezbędny do połączenia ze sklepem za pomocą: REST API. Możesz go uzyskać wysyłając request typu: POST na zasób: Auth przy pomocy podstawowej autoryzacji (BASIC AUTH), czyli podając: login i hasło sklepu. Stworzyliśmy gotową kolekcję zawierającą następujące requesty:
- POST login/password – request wykorzystuje adres sklepu, login, hasło zapisane w środowisku do wygenerowania tokena: {{access_token}},
- POST redirects – request tworzący przekierowania w Panelu administracyjnym sklepu. Jest to przykładowy request zawierający zmienną z tokenem w zakładce: Authorization > Type > Bearer Token > {{access_token}}, czyli przekazanie tokena z powyższego requesta: POST login/password.
W obrębie środowiska Shoper Environment możesz tworzyć requesty wykorzystując zmienną: {{access_token}}, aby w łatwy i przyjemny sposób autoryzować się ze sklepem.


Import pliku z przekierowaniami 301
Jak uzupełnić plik z przekierowaniami 301 dla sklepu Shoper?
Otwórz plik CSV (separator kolumn to przecinek), który udostępniliśmy w punkcie 1 (krok 4) i uzupełnij go według poniższych zasad np.

{{type}} – typ przekierowania.
Dostępne wartości:
- 0 – przekierowanie na własny adres URL,
- 1 – przekierowanie na produkt,
- 2 – przekierowanie na kategorię,
- 3 – przekierowanie na producenta,
- 4 – przekierowanie na stronę informacyjną,
- 5 – przekierowanie na wpis bloga,
- 6 – przekierowanie na kategorię bloga.
{{route}} – ścieżka, z której chcesz dokonać przekierowania (względny, stary adres url).
{{target}} – nowy adres url (uzupełniasz tylko jeżeli typ przekierowania to 0 tj. na własny adres url – jeżeli przekierowanie ma być na ID obiektu to zostawiasz to pole puste.
{{object_id}} – ID obiektu na który ma być przekierowanie np. ID produktu, ID kategorii (uzupełniasz tylko jeżeli typ przekierowania to 1,2,3,4,5,6 tj. na ID obiektu – jeżeli przekierowanie ma być na własny url to zostawiasz to pole puste).
{{lang_id}} – ID języka, na który ma kierować przekierowanie.
Przykład 1: Chcesz utworzyć przekierowanie na własny adres url dla języka polskiego. Zmienne powinny zawierać następujące wartości: {{type}} – 0.
{{route}} – „/product/woman/underwear/3237861/3”
{{target}} – /nowy-adres
{{lang_id}} – 1
Przykład 2: Chcesz utworzyć przekierowanie na produkt o ID 1795 dla języka polskiego. Zmienne powinny zawierać następujące wartości:
{{type}} – 1
{{route}} – „/product/woman/underwear/3237861/3”
{{object_id}} – 1795
{{lang_id}} – 1
Przykład 3: Chcesz utworzyć przekierowanie na stronę informacyjną o ID 2 dla języka angielskiego. Zmienne powinny zawierać następujące wartości:
{{type}} – 4
{{route}} – „/howtobeamillionare.html”
{{object_id}} – 2
{{lang_id}} – 2
WAŻNE! Każdy obiekt w sklepie ma swoje indywidualne ID. W przypadku produktów ID nie można mylić z kodem produktu, ponieważ są to dwie różne dane. W przypadku języków, język polski ma zwykle ID: 1, angielski ID: 2, natomiast każde kolejne mają ID odpowiednio wyższe, zgodnie z zasadami inkrementacji.
Import pliku

- shop_url (adres sklepu),
- login (login administratora z dostępem do WebAPI),
- password (hasło administratora).

Jeżeli zalogujesz się poprawnie otrzymasz zwrotny status: 200 (D) oraz w body informację jaki jest twój: access token (E).





Wgrane przekierowania będą widoczne w Panelu administracyjnym sklepu: Ustawienia (A) > Zaawansowane (B) > Przekierowania (C).

Kody błędów i wiadomości możesz sprawdzić na stronie: Shoper Developers.
Warto zapamiętać!
- Co jest potrzebne do stworzenia masowego importu przekierowań 301?
- Jak wykonać import gotowego środowiska do programu Postman?
- Jak autoryzować połączenie ze sklepem i zaimportować kolekcję?
- Jak wgrać przekierowania 301 do sklepu z poziomu programu Postman?