Wypróbuj za darmo

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

    Import przekierowań za pomocą API nie jest objęty wsparciem technicznym

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

      1.1. 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ć tutaj.

      1.2. Dostęp do sklepu i WebAPI

      Wytyczne, w jaki sposób uzyskać dostęp do WebAPI są dostępne tutaj.

      1.3. Dostęp do dokumentacji technicznej

      Pełna dokumentacja techniczna oprogramowania Shoper jest dostępna tutaj.

      1.4. Plik CSV z odpowiednio skonstruowaną strukturą przekierowań

      Pobierz szablon struktury przekierowań.
    2. 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.

      2.1. Jak zaimportować środowisko?

      a. W lewym menu aplikacji Postman kliknij w ikonę ustawień środowiska, a następnie wybierz Import

      b. Kliknij upload files, wybierz pobrany wcześniej plik środowiska z dysku komputera, następnie kliknij w Import
    3. 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.


      3.1. Jak zaimportować kolekcję?

      a. Pobierz przykładową kolekcję

      b. W lewym menu aplikacji Postman przejdź do zakładki Collections i kliknij Import

      c. Następnie kliknij przycisk upload files, wybierz z dysku komputera pobrany wcześniej plik, następnie kliknij Import

    4. Import pliku z przekierowaniami

      a) Otwórz plik CSV (separator kolumn to przecinek), który udostępniliśmy w punkcie 1.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

      UWAGA: 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.

      b) Import:

      4.1
      W prawym górnym rogu aplikacji Postman wybierz wcześniej zaimportowane środowisko Shoper Environment

      4.2 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)

      4.3 Wróć do kolekcji i zaloguj się do sklepu

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

      4.4
      Uruchom całą kolekcję wybierając jej katalog nadrzędny i kliknij przycisk Run

      4.5 W ustawieniach pozostaw aktywny checkbox tylko przy redirect (logowanie odznacz, ponieważ w punkcie 4.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 między requestami na 200 milisekund i wybierz wcześniej przygotowany plik CSV klikając w select file

      4.6 Uruchom import

      4.7 Import został wykonany poprawnie o czym świadczy status 200 OK (dla każdego wgrywanego wiersza osobno). Po prawej stronie aplikacji widać również informację ile wierszy zostało zaimportowanych

      4.8 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.

    Przetestuj sklep internetowy
    Shoper przez 14 dni za darmo

    Podając maila akceptujesz Regulamin i Politykę Prywatności