Podstawowym i rozwijanym API Allegro jest REST API. Skorzystaj z niego, jeśli tworzysz nową aplikację lub myślisz o rozwoju obecnej. WebAPI to stare rozwiązanie, które utrzymujemy głównie z uwagi na kompatybilność wsteczną z istniejącymi aplikacjami. Nie rozwijamy go już i planujemy jego wygaszenie. Wszelkie nowe funkcjonalności wdrażamy tylko na REST API.

Allegro WebAPI

Interfejs programistyczny platformy Allegro

Aktualności RSS - changelog RSS - Wszystkie

Tutaj znajdziesz najnowsze informacje dotyczące zmian i wydarzeń związanych z WebAPI.

8 kwietnia 2015 r.

Komunikaty techniczne

Przerwa serwisowa środowiska WebAPI Sandbox

W dniu jutrzejszym około godz. 9 rozpoczniemy przerwę serwisową środowiska WebAPI Sandbox, która potrwa ok. 2-3 godzin.

Przypominam, ż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). Szczegóły na ten temat znajdują się na dedykowanej stronie usługi.

Podyskutuj o zmianach na forum usługi

3 kwietnia 2015 r.

Changelog

Zmiana obligatoryjności części parametrów

Data wdrożenia: 15 kwietnia 2015 r.
Za niecałe dwa tygodnie zostanie zmieniona obligatoryjność parametrów w kilku działach. Szczegóły na ten temat znajdują się w tym komunikacie.

Lista kategorii oraz parametrów jest dostępna w poniższych plikach PDF:

Podyskutuj o zmianach na forum usługi

2 kwietnia 2015 r.

Changelog

Zmiany związane z PayU i Escrow na Aukro.ua

Data wdrożenia: 2 kwietnia 2015 r.
W dniu dzisiejszym wyłączyliśmy możliwość wystawiania, wznawiania i autowznawiania ofert z PayU i Escrow na Aukro.ua.

Podyskutuj o zmianach na forum usługi

31 marca 2015 r.

Changelog

Nowe forum WebAPI oraz Menedżera sprzedaży

Data wdrożenia: 31 marca 2015 r.
Zgodnie z informacją sprzed kilku dni, 1 kwietnia zostanie wyłączone i usunięte obecne Cafe Allegro. Oznacza to, że zniknie również dotychczasowe forum Allegro WebAPI.

Wiemy jednak, że Cafe Allegro WebAPI jest ważnym kanałem kontaktu z nami (obok forularza kontaktowego). W związku z tym dla naszej usługi zostało uruchomione zupełnie nowe forum, funkcjonujące obok równie nowego forum Menedżera Sprzedaży. Od dzisiaj można je znaleźć pod adresem:

Podyskutuj o zmianach na forum usługi

20 marca 2015 r.

Komunikaty techniczne

Problem z metodą doGetSiteJournalDealsInfo

Od czwartku, 19 Marca do dnia dzisiejszego (piątek, 20 marca) występował problem z metodą doGetSiteJournalDealsInfo. Przy każdym wywołaniu zwracała ona w polu dealEventsCount wartość 10000.

Źródło tego problemu zostało usunięte i odpowiedzi z tej metody są już zwracane prawidłowo.

Za zaistniałe problemy serdecznie przepraszamy.

Podyskutuj o zmianach na forum usługi

19 marca 2015 r.

Changelog

Obsługa tagów w ofertach ze Strefy Marek

Data wdrożenia: 26 marca 2015 r.
Za tydzień, analogicznie do zmian z zeszłego tygodnia, do metod doCheckNewAuctionExt oraz doChangeItemFields dodamy nową strukturę umożliwiającą obsługę tagów w ofertach. Funkcjonalność będzie dostępna jedynie dla sprzedawców ze Strefy Marek:

   tags | TagNameStruct | niewymagany
       Struktura zawierająca informacje o tagach uzupełniających dane przedmiotu wystawianego dla Strefy Marek. Możliwość tagowania ofert posiadają wyłącznie sprzedawcy ze Strefy Marek. Maksymalnie do oferty można dodać 10 tagów.
         tagName | string | niewymagany
             Nazwa taga przypisywanego do wystawianej oferty. Tagi są przypisane do sprzedającego oraz są widoczne w polu "Podkategorie" na liście ofert sprzedającego. Nowe tagi zostają automatycznie dodawane do listy tagów.

W przypadku edycji oferty za pomocą doChangeItemFields, tagi podawane podczas wywołania metody zastąpią istniejące już tagi w modyfikowanej ofercie.

Równocześnie w tych metodach pojawią się również nowe kody błędów:

ERR_SHOPS_SETTINGS_INVALID_TAGS - Przekazano nieprawidłowe tagi (podczas tworzenia oferty jako StrefaMarek)
ERR_SHOPS_SETTINGS_TAGS_COUNT_LIMIT_EXCEEDED - Przekroczono limit liczby tagów - maksymalnie 10 tagów w ofercie (podczas tworzenia oferty jako StrefaMarek)
ERR_BRAND_ZONE_SERVICE_IS_UNAVAILABLE - Błąd podczas weryfikacji, czy użytkownik jest dostępny w usłudze Strefy Marek ((podczas tworzenia oferty jako StrefaMarek).
ERR_UNKNOWN_FEATURE - Nie możesz dodać tagów do oferty jeśli nie jesteś sprzedającym ze Strefy Marek.

Podyskutuj o zmianach na forum usługi

9 marca 2015 r.

Changelog

Dodawanie tagów do ofert ze Strefy Marek

Data wdrożenia: 12 marca 2015 r.
W czwartek do metody doNewAuctionExt dodamy nową strukturę. Będzie ona umożliwiała dodawanie tagów do wystawianych ofert. Funkcjonalność będzie dostepna jedynie dla sprzedawców ze Strefy Marek:

    7. tags | TagNameStruct | niewymagany
       Struktura zawierająca informacje o tagach uzupełniających dane przedmiotu wystawianego dla Strefy Marek. Możliwość tagowania ofert posiadają wyłącznie sprzedawcy ze Strefy Marek. Maksymalnie do oferty można dodać 10 tagów.
          1. tagName | string | niewymagany
             Nazwa taga przypisywanego do wystawianej oferty. Tagi są przypisane do sprzedającego oraz są widoczne w polu "Podkategorie" na liście ofert sprzedającego. Nowe tagi zostają automatycznie dodawane do listy tagów.

Pojawią się również nowe kody błędów:

ERR_SHOPS_SETTINGS_INVALID_TAGS - Przekazano nieprawidłowe tagi (podczas tworzenia oferty jako StrefaMarek)
ERR_SHOPS_SETTINGS_TAGS_COUNT_LIMIT_EXCEEDED - Przekroczono limit liczby tagów - maksymalnie 10 tagów w ofercie (podczas tworzenia oferty jako StrefaMarek)
ERR_BRAND_ZONE_SERVICE_IS_UNAVAILABLE - Błąd podczas weryfikacji, czy użytkownik jest dostępny w usłudze Strefy Marek ((podczas tworzenia oferty jako StrefaMarek).
ERR_UNKNOWN_FEATURE - Nie możesz dodać tagów do oferty jeśli nie jesteś sprzedającym ze Strefy Marek.

Podyskutuj o zmianach na forum usługi

3 marca 2015 r.

Komunikaty techniczne

Przerwa serwisowa środowiska WebAPI Sandbox [AKTUALIZACJA: 05.03]


W dniu jutrzejszym około godz. 9 rozpoczniemy przerwę serwisową środowiska WebAPI Sandbox, która potrwa ok. 2-3 godzin.

Przypominam, ż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). Szczegóły na ten temat znajdują się na dedykowanej stronie usługi.

AKTUALIZACJA 05.03

Z powodu problemów technicznych Sandbox jest obecnie niedostępny. Ponowne uruchomienie środowiska powinna nastąpić w dniu dzisiejszym w godzinach późno popołudniowych.

Przepraszamy za niedogodności z tym związane.

Podyskutuj o zmianach na forum usługi

18 lutego 2015 r.

Changelog

Uruchamiamy oferty trwające do wyczerpania przedmiotów!

Data wdrożenia: 26 lutego 2015 r.
Już za tydzień nastąpi długo oczekiwane udostępnienie Oferty trwającej do wyczerpania przedmiotów, którą zapowiedzieliśmy w tym komunikacie.

Dla przypomnienia - nowy typ oferty będzie dostępny tylko w ramach Sklepów Allegro. Aby wystawić ofertę tego typu za pośrednictwem Allegro WebAPI należy w fidzie 4 przekazać wartość 99 ("Do wyczerpania"). Tak wystawiona oferta będzie trwać, jak sama nazwa wskazuje, dopóki nie zostaną wyprzedane wszystkie oferowane w niej przedmioty lub sprzedający jej ręcznie nie zakończy. Ważny jest również fakt, że oferty z ustawionym autowznowieniem z niesprzedanymi przedmiotami staną się automatycznie ofertami trwającymi do wyczerpania przedmiotów (nie zakończą się po trzydziestu dniach).

Z racji swojego charakteru, ten typ oferty posiada kilka innych niż zwykle cech:
  • opłaty w ramach oferty trwającej do wyczerpania przedmiotów naliczane są cyklicznie co 30 dni
  • oferta przemieszcza się po listingu tak samo jak każda inna oferta z upływającym czasem (przy sortowaniu po czasie zakończenia), ale po 30 dniach oferta na nowo odlicza ten czas i ponownie przesuwa się po listingu wykonując na nowo tą samą drogę
  • "Popularność" takiej oferty NIE JEST resetowana po każdych 30 dniach
Oferta trwająca do wyczerpania przedmiotów będzie dostępna w Allegro.pl oraz Aukro.cz.

Podyskutuj o zmianach na forum usługi

10 lutego 2015 r.

Changelog

Nowe obowiązkowe parametry [AKTUALIZACJA: 26.02]

Data wdrożenia: 9 marca 2015 r.
Za niecałe trzy tygodnie zostaną wprowadzone nowe obowiązkowe parametry w kilku działach. Szczegóły na ten temat znajdują się w tym komunikacie.

Lista kategorii oraz nowych parametrów jest dostępna w tym pliku PDF.

AKTUALIZACJA 26.02

Z powodów technicznych musimy przełożyć powyższą zmianę. Nastąpi ona 9 marca.

Podyskutuj o zmianach na forum usługi