API merXu

Przeczytaj ten artykuł jeśli chcesz wstawiać oferty przy użyciu API.

Zanim rozpoczniesz integrację, wygeneruj dane dostępowe do aplikacji w zakładce:
Moje merXu> Ustawienia> Ustawienia integracji> Poświadczenia klienta: Wygeneruj nowe poświadczenia

W polu client id uzupełnij swoją nazwę aplikacji.
Dane te są generowane jednorazowo dla każdej integracji niezależnie od liczby użytkowników lub zapytań wykonywanych.
Mogą to być dowolne znaki, pamiętaj jednak, że muszą być unikatowe, to znaczy nie możesz ich ponownie użyć. 

W polu client secret wpisz wybrane przez siebie hasło. Powinno mieć przynajmniej 8 znaków - w tym znak specjalny, cyfrę i wielką literę.

Po wygenerowaniu danych dostępowych przejdź do dokumentacji API udostępnionej pod przyciskiem merXu API:

Po zalogowaniu otrzymasz dwa tokeny:

accessToken - token, który należy wykorzystać przy każdym następnym zapytaniu w celu uwierzytelnienia. Czas ważności tokenu wynosi 30 minut;

refreshToken - token służący do wygenerowania nowego accessToken.

API dostępne jest we wszystkich językach, które są wspierane przez merXu. Aby otrzymać dane w porządanym języku należy wykorzystać nagłówek accept-language (https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Accept-Language) - np. “Accept-language: pl-PL” lub “Accept-language: pl”.