Masowy import przekierowań 301 do sklepu za pośrednictwem API
Ostatnia aktualizacja: 24 kwietnia 2024Przygotowanie 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 oraz w body informację jaki jest twój: access token.
Wgrane przekierowania będą widoczne w Panelu administracyjnym sklepu: Ustawienia > Zaawansowane > Przekierowania.
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?