Pierwsze kroki
Jak wygenerować klucz API w panelu sprzedawcy Empik?
Klucz API wygenerujesz w panelu sprzedawcy Empiku w ustawieniach swojego użytkownika. Najlepiej zrób to dla osobnego użytkownika, bo nowy klucz unieważnia poprzedni.
Czym jest klucz API Empiku?
Klucz API to ciąg znaków, którym program przedstawia się Empikowi zamiast loginu i hasła. Daje dostęp do tych samych danych, które widzisz w panelu sprzedawcy: ofert, cen, zamówień, wiadomości i wskaźników konta. Empik Marketplace działa na systemie Mirakl, więc API ma ten sam układ co na innych marketplace'ach opartych na Mirakl.
Krok po kroku
W skrócie
- 1Panel sprzedawcy Empikosobny użytkownik dla integracji, ustawienia użytkownika, klucz API
- 2Nowy kluczskopiuj w całości, bez spacji
- 3oGrosika, zakładka Połączeniewklej i zapisz
- 4Test połączeniapokaże nazwę i numer Twojego sklepu na Empiku
- Zaloguj się do panelu sprzedawcy Empik Marketplace. Najlepiej jako użytkownik utworzony specjalnie dla integracji, np. „integracje”.
- Otwórz ustawienia użytkownika. Kliknij swoje konto w prawym górnym rogu i wybierz ustawienia użytkownika. Nazwy pozycji w panelu mogą się nieco różnić zależnie od wersji.
- Przejdź do zakładki z kluczem API i wygeneruj nowy klucz.
- Skopiuj klucz od razu i w całości. Nie dodawaj spacji na początku ani na końcu.
- Wklej go w oGrosika. Przy pierwszym sklepie formularz pojawia się po rejestracji; później klucz zmienisz w zakładce Połączenie.
- Zapisz i przetestuj. oGrosika od razu sprawdza połączenie i pokazuje nazwę oraz numer sklepu na Empiku.
Adres API
Domyślny adres API Empik Marketplace to https://marketplace.empik.com i w większości przypadków nie trzeba go zmieniać. Pole adresu jest w zakładce Połączenie obok klucza.
Jak przechowujemy klucz?
Klucz zapisujemy zaszyfrowany. Po zapisie nie da się go odczytać w panelu, można go tylko podmienić; widać jedynie cztery ostatnie znaki. Szczegóły opisujemy na stronie jak chronimy klucz API.
Test połączenia nie przechodzi
| Objaw | Co sprawdzić? |
|---|---|
| „To nie wygląda na klucz API” | Klucz jest za krótki albo zawiera spację. Skopiuj go jeszcze raz. |
| Błąd autoryzacji | Klucz został unieważniony, bo ktoś wygenerował nowy dla tego samego użytkownika. Wygeneruj klucz ponownie. |
| Brak połączenia | Sprawdź adres API (musi zaczynać się od https://). Jeśli jest poprawny, spróbuj za kilka minut. |
| Sklep jest już podłączony do innego konta | Ten sam sklep Empiku może być podłączony tylko do jednego konta. Napisz do nas. |
Co dalej?
Po połączeniu oGrosika pobiera katalog w tle; przy kilkunastu tysiącach ofert trwa to około pół godziny. W tym czasie możesz przygotować progi cen: wczytanie cen minimalnych z arkusza. Gdy będą gotowe, przeczytaj, kolejność reguł i progów. Po panelu sprzedawcy Empiku prowadzi wpis jak zacząć sprzedawać na Empiku.
Pytania
Gdzie znajdę klucz API Empiku?
W panelu sprzedawcy Empik Marketplace, w ustawieniach Twojego użytkownika, w zakładce z kluczem API.
Czy wygenerowanie nowego klucza odłączy inne programy?
Tak, jeśli korzystają z klucza tego samego użytkownika, bo nowy klucz unieważnia poprzedni. Dlatego warto utworzyć osobnego użytkownika dla każdej integracji.
Jaki jest adres API Empik Marketplace?
Domyślnie https://marketplace.empik.com. W oGrosika jest ustawiony automatycznie.
Czy oGrosika widzi mój klucz po zapisaniu?
Klucz jest zaszyfrowany i nie da się go odczytać w panelu. Można go tylko podmienić na nowy.