Integracja z Allegro
Aby rozpocząć integrację systemów, przejdź do modułu Użytkownicy i wywołaj formatkę dodawania nowego konta (ikona ).
Na zakładce Dane konta wpisz nazwę konta, która będzie widoczna w systemie Wapro Aukcje Anywhere, wybierz pozycję Allegro i uzupełnij wszystkie pola:
- Login - login używany w systemie Allegro,
- Hasło - hasło do portalu Allegro,
- Klucz WebAPI - specjalny wygenerowany klucz do łączenia się z aplikacją,
- Client id - identyfikator wymagany do komunikacji z REST API do wygenerowania z apps.developer.allegro.pl,
- Client secret - unikalny tajny klucz używany do komunikacji z REST API do wygenerowania z apps.developer.allegro.pl,
- Imię i nazwisko - dane wprowadzone także w Allegro.
- Adres e-mail - e-mail powiązany z kontem Allegro.
Jak uzyskać klucz WebAPI, Client id oraz Client secret?
W celu wygenerowania klucza WebAPI, Client id oraz Client secret należy zalogować się danymi konta Allegro na stronie: apps.developer.allegro.pl
W prawym górnym rogu wybierz opcję Zarejestruj nową aplikację
- pojawi się formularz rejestracji aplikacji.
- Nazwa aplikacji - własna nazwa aplikacji, dla której generowany jest klucz WebAPI. Nazwa jest ważna, jeśli korzystasz z haseł aplikacyjnych w portalu Allegro.
- Rodzaj aplikacji - wybierz domyślnie zaznaczoną opcję Aplikacja będzie posiadać dostęp do przeglądarki, za pomocą której użytkownik będzie się logował do Allegro.
- Adresy URL do przekierowania - wklej link: https://app.wapro.pl/, zaakceptuj regulamin i kliknij
Dodaj
. Na kolejnym oknie zarządzania aplikacjami został wygenerowany klucz WebAPI, który wklejamy w danych konta.
Jak wygenerować hasła aplikacyjne?
Jeżeli w Allegro włączone są hasła aplikacyjne, w celu poprawnej autoryzacji programu wygeneruj hasło dla aplikacji aukcyjnej.
Hasła do aplikacji możesz sprawdzić na Allegro, wchodząc w Moje Konto | Bezpieczeństwo | Hasła do aplikacji
.
Jeżeli hasła aplikacyjne są włączone, wygeneruj hasło dla aplikacji aukcyjnej. W tym celu wpisz nazwę aplikacji, która została podana podczas generowania klucza WebAPI i kliknij Wygeneruj hasło
. Allegro utworzy hasło do aplikacji. Zostanie ono wyświetlone TYLKO jeden raz. Hasło powinieneś wkleić w ustawieniach konta w programie Wapro Aukcje Anywhere.
Jak autoryzować aplikację?
Autoryzacja aplikacji wymagana jest w celu nawiązania połączenia z API usługi Allegro.
Czym jest REST API?
Rest API to dodatkowa usługa sieciowa udostępniona przez Allegro do komunikacji z portalem. REST API jest odrębnym zestawem funkcji niż obecna usługa WebAPI Allegro - ma udostępniony inny zestaw funkcji, a sama integracja odbywa się w innej technologii niż z WebAPI, które wykorzystuje tzw. protokół SOAP.
Konsekwencją wprowadzenia nowego typu API przez Allegro jest dodanie dodatkowej warstwy uwierzytelniania żądań od użytkownika do Allegro.
W praktyce dla użytkownika oznacza to dodatkowe logowanie w aplikacji Wapro Aukcje danymi z Allegro po to, aby aplikacja w imieniu użytkownika mogła odpytywać usługę REST API.
Jak zweryfikować konto?
Proces autoryzacji polega na uruchomieniu w aplikacji opcji weryfikacji, która wyświetla stronę logowania do Allegro. Po wprowadzeniu danych do logowania (na stronie dostarczonej przez Allegro) i wyrażeniu akceptacji co do autoryzacji danej aplikacji (aplikacja przedstawia się w formie unikalnego identyfikatora) nastąpi zamknięcie okna autoryzacji.
Opcja weryfikacji jest dostępna w dwóch miejscach:
- w oknie edycji danych użytkownika (po wstępnej synchronizacji):
- w prawym górnym rogu obok listy wyboru kont:
Następnie pojawi się okno z logowaniem do aplikacji:
Po wprowadzeniu danych do logowania nastąpi przekierowanie do akceptacji autoryzacji aplikacji. Po jej wykonaniu okno zamknie się automatycznie.
Jeśli autoryzacja przebiegnie prawidło, zostanie pobrany tzw. token aplikacji - jest on ważny 12 h. Dodatkowo aplikacja pobierze tzw. token odświeżenia, dzięki któremu będzie mogła przedłużać o kolejne 12 h token podstawowy aplikacji w cyklicznych zapytaniach do usługi Allegro.
Ważne jest jednak to, że tokenem odświeżającym można przedłużyć ważność tokena podstawowego do maksymalnie 365 dni. W związku z tym użytkownik będzie musiał się zalogować do Allegro przynajmniej raz w danym roku, aby uwierzytelnić aplikację.
Po pobraniu tokena system automatycznie próbuje pobrać warunki posprzedażowe z danych konta Allegro (należy je uzupełnić o informacje o sprzedającym po zalogowaniu się do Allegro). Ich lista dostępna jest w menu Aukcje | Kartoteka | Warunki posprzedażowe
.
Warunki można uzupełnić w trakcie wystawiania lub grupowej edycji aukcji. W trakcie wystawiania lista dostępna jest w zakładce Płatność i dostawa, a w trakcie edycji w zakładce Podstawowe.
Dla kont sklepowych należy uzupełnić wszystkie warunki posprzedażowe, w przeciwnym razie API Allegro odrzuci aukcje.