Masowy import przekierowań 301 do sklepu za pośrednictwem API

Data publikacji: 3 lipca 2018 Ostatnia aktualizacja: 12 czerwca 2024

Przygotowanie narzędzi pomocnych do tworzenia przekierowań 301 dla sklepów na platformie Shoper

Instalacja programu Postman.

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.

Dostęp do dokumentacji technicznej
Plik CSV z odpowiednio skonstruowaną strukturą przekierowań.

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.

W lewym menu aplikacji Postman wybierz kafelek: Environments (ustawień środowiska) – (A), a następnie kliknij: Import (B).
Program Postman > Environments > Import
Rys 1. Zaimportuj plik ze środowiskiem do programu Postman.
Program Postman > Environments > Import
Rys 1. Zaimportuj plik ze środowiskiem do programu Postman.
Kliknij: upload files, wybierz pobrany wcześniej plik środowiska z dysku komputera, a następnie kliknij: Import.
Program Postman > Environments > Import > Select files to import
Rys 2. Rozpocznij import gotowego środowiska Shoper w Postman.
Program Postman > Environments > Import > Select files to import
Rys 2. Rozpocznij import gotowego środowiska Shoper w Postman.

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.

Pobierz przykładową kolekcję.
W lewym menu aplikacji: Postman przejdź do zakładki: Collections (A) i kliknij: Import (B).
Program Postman > Collections > Import
Rys 3. Zaimportuj przygotowaną wcześniej kolekcję przy użyciu programu Postman.
Program Postman > Collections > Import
Rys 3. Zaimportuj przygotowaną wcześniej kolekcję przy użyciu programu Postman.
Następnie kliknij przycisk: upload files, wybierz z dysku komputera pobrany wcześniej plik, a następnie kliknij: Import.
Program Postman > Collections > Import > Select files to import
Rys 4. Znajdź gotową kolekcję z przekierowaniami i zaimportuj ją poprzez Postman.
Program Postman > Collections > Import > Select files to import
Rys 4. Znajdź gotową kolekcję z przekierowaniami i zaimportuj ją poprzez Postman.

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.

Przykładowy plik CSV z przekierowaniami 301
Rys 5. Uzupełnij plik CSV na podstawie przedstawionego schematu dla sklepu Shoper.
Przykładowy plik CSV z przekierowaniami 301
Rys 5. Uzupełnij plik CSV na podstawie przedstawionego schematu dla sklepu Shoper.

{{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

W prawym górnym rogu aplikacji: Postman wybierz wcześniej zaimportowane środowisko: Shoper Environment.
Program Postman > Shoper Environment
Rys 6. Przełącz na zaimportowane środowisko dla sklepu internetowego Shoper.
Program Postman > Shoper Environment
Rys 6. Przełącz na zaimportowane środowisko dla sklepu internetowego Shoper.
Kliknij ikonę: oka i w kolumnie: CURRENT VALUE uzupełnij dane logowania do sklepu:
  • shop_url (adres sklepu),
  • login (login administratora z dostępem do WebAPI),
  • password (hasło administratora).
Program Postman > Shoper Environment > Current Value
Rys 7. W kolumnie: CURRENT VALUE podaj dane dostępowe do konta administratora.
Program Postman > Shoper Environment > Current Value
Rys 7. W kolumnie: CURRENT VALUE podaj dane dostępowe do konta administratora.
Wróć do kolekcji (A) i wybierz: POST Logowanie login/password (B), a następnie wyślij zapytanie do sklepu (C).

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

Program Postman > Collections > Post Logowanie > Send
Rys 8. Sprawdź, czy udało się zalogować do sklepu Shoper z poziomu aplikacji Postman.
Program Postman > Collections > Post Logowanie > Send
Rys 8. Sprawdź, czy udało się zalogować do sklepu Shoper z poziomu aplikacji Postman.
Uruchom całą kolekcję wybierając jej katalog nadrzędny (A) i kliknij przycisk: Run (B).
Program Postman > Collections > API Rest Shoper > Run
Rys 9. Wybierz kolekcję z przekierowaniami 301 i odpal program Postman.
Program Postman > Collections > API Rest Shoper > Run
Rys 9. Wybierz kolekcję z przekierowaniami 301 i odpal program Postman.
W ustawieniach pozostaw aktywny checkbox tylko przy: redirect (logowanie odznacz (A), ponieważ w kroku 3 zalogowałeś się już ręcznie i nie ma potrzeby, aby program wgrywając każdy wiersz z pliku logował się na nowo). Wpisz opóźnienie: Delay (B) między requestami na: 200 milisekund i wybierz wcześniej przygotowany plik CSV klikając: select file (C).
Program Postman > Collections > Run > Run Order
Rys 10. Przygotuj plik CSV z kolekcją i ustal opcje wgrywania wierszy do sklepu.
Program Postman > Collections > Run > Run Order
Rys 10. Przygotuj plik CSV z kolekcją i ustal opcje wgrywania wierszy do sklepu.
Uruchom import: Run API Rest Shoper – przekiero…
Program Postman > Collections > Run > Runner
Rys 11. Zatwierdź proces masowego importu przekierowań 301 w programie Postman.
Program Postman > Collections > Run > Runner
Rys 11. Zatwierdź proces masowego importu przekierowań 301 w programie Postman.
Import został wykonany poprawnie o czym świadczy status: 200 OK (dla każdego wgrywanego wiersza osobno) – (A). Po prawej stronie aplikacji widać również informację (B), ile wierszy zostało zaimportowanych.
Program Postman > Collections > API Rest Shoper > Iteration 1
Rys 12. Możesz sprawdzić każdą iterację wiersza, czy zakończyła się sukcesem.
Program Postman > Collections > API Rest Shoper > Iteration 1
Rys 12. Możesz sprawdzić każdą iterację wiersza, czy zakończyła się sukcesem.

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

Panel administracyjny sklepu > Ustawienia > Zaawansowane > Przekierowania
Rys 13. Sprawdź, czy przekierowania 301 pojawiły się w Panelu administracyjnym sklepu Shoper.
Panel administracyjny sklepu > Ustawienia > Zaawansowane > Przekierowania
Rys 13. Sprawdź, czy przekierowania 301 pojawiły się w Panelu administracyjnym sklepu Shoper.

Kody błędów i wiadomości możesz sprawdzić na stronie: Shoper Developers.

Warto zapamiętać!
W powyższym artykule zostało wyjaśnione:
  • 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?
Czy ten artykuł był pomocny?
Tak
Nie
Dziękujemy za odpowiedź!
Udostępnij artykuł:

Przetestuj sklep internetowy
przez 14 dni za darmo

Korzystaj ze wszystkich funkcji oprogramowania za darmo i bez zobowiązań.

Testuj wszystkie funkcje przez 14 dni bez zobowiązań. Zakładając sklep poprzez podanie
adresu e-mail akceptujesz nasz Regulamin i Politykę Prywatności