Aktualności

Do 31 maja zaktualizuj protokół szyfrowania danych TLS

TLS (ang. Transport Layer Security) zapewnia poufność i integralność transmisji danych. Wersja 1.0 powstała w 1999 roku i nie spełnia już dzisiejszych standardów bezpieczeństwa.

Zaktualizuj oprogramowanie na serwerze i połącz się z Allegro za pomocą protokołu TLS 1.1 lub 1.2. Instrukcje, jak to zrobić,znajdziesz w artykule naszej Pomocy.

Ważne! Jeżeli nie zaktualizujesz oprogramowania na serwerze, wówczas:

• po 31 maja: stracisz możliwość pobierania, tworzenia i edycji danych przez API Allegro. Jeśli wyślesz request z takiego serwera, to otrzymasz komunikat błędu, że używasz przestarzałej wersji protokołu TLS. Pełne wersje komunikatów dostępne są w naszej pomocy.
• po 30 czerwca: nie będziesz mógł nawiązać połączenia z API Allegro.

Zmiany w obsłudze kluczy API

Wdrożyliśmy kilka zmian w obsłudze kluczy przez Allegro WebAPI i REST API.

Aktualizacja - kalkulator opłat

Wprowadzamy zmianę w kalkulatorze opłat w REST API. Dodaliśmy nowy parametr do pola “offer”: “condition” czyli parametr “Stan”.

Przerwa techniczna

17 maja w godzinach 01:00 - 03:00 przeprowadzimy prace modernizacyjne w serwisie Allegro.

W tym czasie REST API Allegro będzie niedostępne.

Udostępniliśmy parametr typu string

Zgodnie z wcześniejszą zapowiedzią, udostępniliśmy parametr typu string.

Możecie go dodawać do ofert z poziomu Formularza wystawiania, WebAPI i REST API w dwóch kategoriach:

• Fotografia > Aparaty cyfrowe - Model
• Motoryzacja > Części samochodowe > Filtry > Kabinowe - Numer katalogowy

Początkowo parametry typu string nie będą obowiązkowe. Część z nich oznaczymy, jako wymagane w późniejszym czasie.

O wszystkich zmianach będziemy informować ze stosownym wyprzedzeniem.

Nowy rodzaj parametru - zapowiedź

W najbliższych tygodniach udostępnimy nowy rodzaj parametru - parametr stringowy.

Będzie to parametr, w którym będziecie mogli sami zdefiniować wartości.

Będą dostępne dwa rodzaje parametru typu string:

• z jedną wartością
• z wieloma wartościami

Przykładowy parametr stringowy:

Skład:

Bawełna 80%

Elastan 10%

Poliester 10%

Grupowa edycja ofert - poszerzamy możliwości zasobu

Tabele rozmiarów w REST API

Od teraz możesz pobrać identyfikatory Tabel rozmiarów i ich zawartość.

Wystawiaj i zarządzaj ofertami przez REST API

Nowe środowisko testowe - Allegro Sandbox

Przestajemy wspierać domenę https://ssl.allegro.pl

Zgodnie z zapowiedzią przestajemy dziś wspierać domenę https://ssl.allegro.pl ponieważ zmieniliśmy adres domeny w procesie autoryzacji OAuth z https://ssl.allegro.pl na https://allegro.pl

GitHub zamiast Facebooka

Wszystkie profile Allegro.pl na Facebooku połączyliśmy z głównym profilem.

Kilka tygodni temu przeprowadziliśmy ankietę, w której pokazaliście nam, że GitHub jest najlepszym wyborem. Nasze repozytorium znajdziecie tutaj.

Pytania dotyczące API zadawajcie w zakładce Issues.

Przestajemy wspierać domenę https://ssl.allegro.pl

W listopadzie 2017 roku zmieniliśmy adres domeny w procesie autoryzacji OAuth z https://ssl.allegro.pl na https://allegro.pl.

Zgodnie z zapowiedzią domenę https://ssl.allegro.pl przestaniemy wspierać 13 marca. Od tego momentu powinieneś logować się tylko na https://allegro.pl. Zaktualizuj do 13 marca adres domeny w swoim oprogramowaniu.

Przerwa techniczna

28 lutego w godzinach 02:00 - 04:00 przeprowadzimy prace modernizacyjne w serwisie Allegro. W tym czasie REST API Allegro będzie niedostępne.

Zmieniamy nazwę domen allegroapi.io na allegro.pl

Od dziś nasze strony związane z REST API udostępniliśmy w ramach domeny allegro.pl.

Jeśli podasz dotychczasowy adres stron, to przekierujemy cię na nową domenę.

Zmiana dotyczy:

• developer.allegroapi.io (portal developerski) - nowy adres to developer.allegro.pl
• credentials.allegroapi.io (subportal do rejestracji aplikacji) - nowy adres to apps.developer.allegro.pl

Zachęcamy także, abyście zmienili adres, w wywołaniach do REST API z https://allegroapi.io na https://api.allegro.pl. Dotychczasowy adres będziemy nadal utrzymywać przez co najmniej rok, o planowanej dacie jego wygaszenia poinformujemy was z odpowiednim wyprzedzeniem.

Udostępniamy zasób, którym sprawdzicie datę naliczenia kolejnej opłaty w ofercie

Od sierpnia 2017 roku opłaty naliczamy w cyklach 10 dniowych. Dziś udostępniamy zasób, który pozwoli wam w prosty sposób sprawdzić, kiedy dany cykl się skończy i kiedy naliczymy kolejną opłatę.

Rabaty ilościowe i Zestawy promocyjne - nowe pole w odpowiedzi “status”

Poszerzyliśmy response w metodach:

• POST /sale/loyalty/promotions
• GET /sale/loyalty/promotions?user.id={Seller_ID}
• GET /sale/loyalty/promotions/{promotionId}

o nowe pole ‘status’. Dla tego pola dostępne są dwie wartości:

• ACTIVE - oznacza, że w danej ofercie masz wystarczający zapas przedmiotów i promocja jest gotowa do wykorzystania
• SUSPENDED - oznacza, że masz za mały zapas produktów w danej ofercie, aby skorzystać z tej promocji. Aby z niej skorzystać, uzupełnij ilość przedmiotów

WAŻNE! Obecnie dla Zestawów promocyjnych to pole zawsze będzie miało wartość ACTIVE.

Rabaty ilościowe

Poszerzyliśmy możliwości zasobu promotions - od teraz możesz dzięki niemu zarządzać także rabatami ilościowymi. Dzięki rabatom ilościowym możesz zaoferować kupującym rabat na kolejną sztukę, przy zakupie określonej liczby sztuk. Przykładowo: jeśli klient kupi trzy pary soczewek, to czwartą otrzyma 50% taniej.

Udostępniamy zasoby do zarządzania kontaktami

Niedawno udostępniliśmy ogłoszenia w Allegro, dlatego teraz udostępniamy wam zasoby, które pozwolą zarządzać kontaktami w REST API.

Zmieniamy adres domeny w procesie autoryzacji

Zmieniamy adres domeny w procesie autoryzacji OAuth z https://ssl.allegro.pl na https://allegro.pl. Zaktualizowaliśmy informacje na stronie REST API Allegro.

Uwaga! Domenę https://ssl.allegro.pl planujemy wyłączyć w marcu 2018. Od tego momentu użytkownik będzie mógł się zalogować tylko na https://allegro.pl. Zaktualizuj do tego czasu adres domeny w swoim oprogramowaniu.

Grupowa edycja ofert

Udostępniliśmy nowe zasoby do grupowej edycji ofert. Obecnie zasób pozwala na grupowe przypisanie usług dodatkowych. Usługami dodatkowymi są np.: zapakowanie na prezent, wniesienie, montaż itp.

Usługi dodatkowe

Udostępniliśmy naszym sprzedającym usługi dodatkowe w Allegro. Usługami dodatkowymi są np.: zapakowanie na prezent, wniesienie, montaż itp. Sprzedawca może dodać usługi dodatkowe w swoich ofertach.

Kalkulator opłat

Udostępniamy ogłoszenia w Allegro, dlatego wprowadzamy zmiany w kalkulatorze opłat w REST API.

Przerwa techniczna

29 października pomiędzy godziną 1:50, a 3:30 nastąpi przerwa techniczna związana ze zmianą czasu z letniego na zimowy. Serwis będzie w tym czasie niedostępny, a na stronie Allegro pojawi się plansza informująca o przerwie technicznej.

Oferty kończące się w trakcie przerwy przedłużymy o 24 godziny.

Dodatkowo, między godziną 02:00 a 05:00 niedostępna będzie usługa PayU.

Allegro.pl sp. z o.o. łączy się z Grupą Allegro sp. z o.o.

2 listopada br. Allegro.pl sp. z o.o. łączy się z Grupą Allegro sp. z o.o. Wszelkie prawa i obowiązki Grupy Allegro sp. z o.o. przejdą na Allegro.pl sp. z o.o.

Oznacza to, że 2 listopada br. zmieni się nazwa administratora Waszych danych osobowych. Nie ulegną natomiast zmianie zasady ochrony i przetwarzania danych osobowych. Zawsze macie prawo dostępu do treści swoich danych oraz ich poprawiania, a także żądania zaprzestania ich przetwarzania.

W związku z tą zmianą, zaktualizujemy Regulamin Allegro i pozostałe regulaminy usług świadczonych przez Allegro.pl sp. z o.o. Nową wersję Regulaminu Allegro zamieściliśmy w tym dokumencie. Fragmenty, które dodamy zaznaczyliśmy na zielono, a te które usuniemy - na czerwono

Promocyjne zestawy ofert

Udostępniliśmy naszym sprzedającym promocyjne zestawy ofert. Dzięki temu sprzedawca może sprzedawać w obniżonej cenie zestaw kilku ofert.

Nowe zasoby, którymi pobierzesz informacje o ocenach

Udostępniliśmy nowe zasoby dzięki którym - jako zalogowany Użytkownik - pobierzecie otrzymane oceny oraz statystyki ocen. Dotychczasowe zasoby oznaczyliśmy jako depracated i w przyszłości (za około pół roku) usuniemy zupełnie. Dlatego zachęcamy, abyście korzystali z nowych.

Kalkulator opłat

Udostępniliśmy Sprzedającym kalkulator opłat w REST API. Sprzedający mogą sprawdzić jakie opłaty pobieramy w każdej kategorii. W związku z tym 19 pażdziernika wyłączymy metodę doGetPaymentData, która zwraca niedokładne dane.

Punkty odbioru osobistego

Udostępniliśmy naszym sprzedającym punkty odbioru osobistego. Użytkownik może ustawić listę takich punktów. Wyświetlimy je w sekcji Dostawa i płatność we wszystkich jego ofertach z odbiorem osobistym.

Dla punktów odbioru przygotowaliśmy nowe zasoby w REST API Allegro.

Przerwa techniczna

27 lipca pomiędzy godziną 3:00, a 5:30 przeprowadzimy prace modernizacyjne. W tym czasie mogą wystąpić przerwy w działaniu Allegro WebAPI oraz REST API.

Oferty, kończące się w czasie przerwy technicznej, przedłużymy o 24 godziny.

Przerwa techniczna

31 czerwca pomiędzy godziną 3:00, a 5:30 przeprowadzimy prace modernizacyjne. W tym czasie mogą wystąpić przerwy w działaniu Allegro WebAPI oraz REST API.

Oferty, które kończą się w czasie przerwy technicznej, przedłużymy o 24 godziny.

Nowe zasoby, którymi pobierzesz informacje o ocenach

Przygotowaliśmy dwa endpointy dzięki którym pobierzesz informacje o ocenach.

Przerwa techniczna

31 maja pomiędzy godziną 1:00 a 5:00 przeprowadzimy prace modernizacyjne. W tym czasie mogą wystąpić przerwy w działaniu Allegro WebAPI oraz REST API, głównie w kwestiach związanych z płatnościami.

Oferty powinny zakonczyć się w czasie przerwy technicznej, a więc 31.05.2017 od godziny 01:00 do 05:00, przedłużymy o 24 godziny.

Przerwa serwisowa środowiska WebAPI Sandbox

Dzisiaj, 11 maja, o godzinie 12:00 rozpoczniemy przerwę serwisową środowiska WebAPI Sandbox, która potrwa do końca dnia.

Przypominamy, że prace wykonywane podczas przerwy serwisowej skutkują przerwą w dostępie do środowiska oraz permanentnym usunięciem wszelkich danych utworzonych do tej pory na Sandboxie (np. dodatkowi użytkownicy czy transakcje kupna).

Przerwa techniczna

12 maja w godzinach 4:00 - 5:00 przeprowadzimy prace modernizacyjne w serwisie Allegro. W tym czasie możecie odczuć przerwy w działaniu Allegro WebAPI oraz REST API, głównie w kwestiach związanych z logowaniem.

Oferty kończące się w czasie przerwy technicznej, a więc 12.05.2017 od godziny 04:00 do 05:00, zostaną przedłużone o 24 godziny.

Usunięcie zasobów - "Publikuj Ofertę również na Allegro.de"

Usunęliśmy dwa endpointy do hurtowego udostępniania ofert w Allegro.de.

Nowe zasoby - "Warunki oferty"

Przygotowaliśmy trzy endpointy dzięki którym pobierzesz listy warunków oferty.

Przerwa techniczna

15 marca w godzinach 1:00 - 4:00 przeprowadzimy prace modernizacyjne w serwisie Allegro. W tym czasie REST API Allegro może być niedostępne.

Przerwa techniczna

8 lutego między godziną 6:00 a 7:00 zaplanowaliśmy prace modernizacyjne. Podczas trwania przerwy technicznej możecie napotkać chwilowe problemy z wystawianiem i edycją ofert przez API.

Nowe zasoby - "Publikuj Ofertę również na Allegro.de"

Przygotowaliśmy dwa endpointy do hurtowego udostępniania ofert w Allegro.de.

Przerwa techniczna

25 stycznia między godziną 1:30 a 5:00 zaplanowaliśmy prace modernizacyjne. W tym czasie usługa REST API nie będzie dostępna.

Przerwa techniczna

Informujemy, że w środę, 16 listopada, w związku z planowaną przerwą techniczną która będzie miała miejsce od godziny 01:00 do 5:00, usługa REST API Allegro będzie niedostępna.

Przerwa techniczna

Informujemy, że w niedzielę, 30 października, w związku z planowaną przerwą techniczną która będzie miała miejsce od godziny 01:50 (czasu letniego) do 03:30 (czasu zimowego), usługa REST API Allegro będzie niedostępna.

Wydłużyliśmy czas ważności refresh_tokena do 365 dni

Dziękujemy za pierwsze uwagi oraz sugestie dotyczące REST API. Najwięcej zgłoszeń otrzymaliśmy odnośnie procesu autoryzacji, który periodycznie wymaga ingerencji użytkownika. Kwestia ta zostanie rozwiązana w niedalekiej przyszłości – o aktualizacji procesu autoryzacji będziemy informować na bieżąco.

Tymczasem dla aplikacji zarejestrowanych od 06.08.2016 wydłużyliśmy czas ważności refresh_tokena do 365 dni.

Możliwość zmiany ceny Kup Teraz

Od dziś w ramach Allegro REST API masz możliwość modyfikacji ceny w trwających ofertach, nawet jeżeli pojawiła się w nich sprzedaż.

Służy do tego zasób Change the Buy Now price. Zachęcamy do zapoznania się z jego dokumentacją.

Allegro REST API - zaczynamy!

Udostępniliśmy dziś nowy interfejs programistyczny oparty o architekturę REST.

Pierwszy zasób, z którego możecie korzystać w ramach nowego interfejsu to: Change the Buy Now price, który pozwala na zmianę ceny w trwających ofertach, niezależnie od tego czy pojawiła się w nich sprzedaż.