[NEWS] Wygaszamy WebAPI do obsługi ofert i sprzedaży. Korzystaj z REST API

[PawelTaberski]

Od sierpnia 2016 możesz łączyć się z Allegro za pomocą dwóch protokołów API - REST i SOAP. Podstawowym i rozwijanym interfejsem programistycznym Allegro jest REST API, i tylko w nim udostępniamy wszelkie nowe funkcjonalności. W REST API opublikowaliśmy zestaw zasobów, które pozwalają:

• wystawiać i edytować oferty,
• wprowadzać zmiany w wielu ofertach jednocześnie,
• obsługiwać zamówienia.

Plany dla API Allegro

Rozwijamy REST API

Przypominamy, że możesz wystawiać i zarządzać ofertami przez REST API - odpowiednie zasoby są od września 2018 w wersji public.

Harmonogram dla REST API - Luty/Marzec 2019

• Produktyzacja - grupujemy oferty z tym samym produktem
  • planujemy udostępnić zasoby, które pozwolą powiązać nową i istniejącą ofertę z produktem z naszej bazy danych. Zasoby opublikujemy w wersji beta, by poznać twoje uwagi i sugestie.
  • równolegle pracujemy nad zasobami, które pozwolą dodać produkt do naszej bazy.
• zasoby, które pozwalają obsługiwać zamówienia udostępnimy w wersji public. Do tego czasu jesteśmy otwarci i chętnie wysłuchamy twoich uwag i sugestii czego jeszcze brakuje w obsłudze zamówień. Dlatego tym bardziej zachęcamy do testów.
• udostępnimy nowy zasób, którym dodasz informacje o przesyłce.
• wspólnie z InPostem rozwiążemy problem integracji związany z nowymi numerami zamówień.

Wygaszamy WebAPI

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. Nowe funkcjonalności będziemy udostępniać tylko w REST API.

• 3 czerwca 2019 usuniemy metody do obsługi i zarządzania ofertami, które już dziś oznaczamy jako deprecated. Oznacza to, że już teraz odradzamy użycia tych metod w nowych rozwiązaniach i zalecamy migrację na REST API w istniejących rozwiązaniach. Dotyczy to metod:
  • doNewAuctionExt.
  • doChangeItemFields.
  • doGetItemFields.
  • doGetSellFormFieldsForCategory.
  • doFinishItem.
  • doFinishItems.
  • doChangePriceItem.
  • doChangeQuantityItem.
  • doCheckNewAuctionExt.
  • doCheckItemDescription.
• Zgodnie z wcześniejszą zapowiedzią 1 kwietnia 2019 usuniemy metodę doGetItemsList.
• W chwili, gdy udostępnimy w REST API zasoby które pozwalają obsługiwać zamówienia w wersji public oznaczymy metody do obsługi zamówień w WebAPI jako deprecated.

O planach dla innych metod i zasobów w API będziemy informować na bieżąco.

[FromAnyHole]

Zdecydowanie za mało czasu !! Proponuję takie terminy wygaszania WebAPI:

• 2 września 2019 - wszystkie wymienione wyżej metody
• 2 września 2019 - również dla [doGetItemsList] (po co to tak rozdzielacie ??)

[PawelTaberski]

Usunięcie metody doGetItemsList w kwietniu 2019 zapowiedzieliśmy już na początku października 2018, i nie przewidujemy przedłużania tego terminu. Obecnie nie planujemy też przedłużania terminu wygaszenia metod do obsługi i zarządzania ofertami w WebAPI. Terminy rozbiliśmy ze względu na to, że zdecydowaliśmy się zapowiadany w czerwcu 2018 termin kwietniowy usunięcia metod do obsługi i zarządzania ofertami w WebAPI przedłużyć do czerwca.

[walik92]

@PawelTaberski czy jest znana dokładna data usunięcia metody doGetItemsList ? Raczej to będzie na początku kwietnia czy pod koniec? Zgadzam się z @FromAnyHole, że daliście zbyt mało czasu, przejście z SOAP na API RESTowe wymaga trochę pracy. Dodam że w starym API dla tej metody wystarczyło podać klucz WebApi, natomiast w nowym API dochodzi nam proces autoryzacji, co wymaga dodatkowej pracy (dużym ułatwieniem byłoby gdyby autoryzacja zasobu /offers/listing została usunięta, tym bardziej że nie da się w pełni zautomatyzować pozyskanie tokena). Poza tym przedłużenie terminu chociażby do 3 czerwca byłoby miłym gestem z waszej strony.

[TinTours]

Obsługa zamówień w WebAPI z mojej perspektywy musi zostać tak długo, jak nie zostanie przeniesiona do REST API obsługa wypłat - inaczej nie będziemy w stanie powiązać transakcji z wypłatami i cała apka przestaje działać...

[PawelTaberski]

@walik92 Zasób /offers/listing jest publiczny i możesz wtedy skorzystać z autoryzacji typu Client_credentials, i ten proces możesz sobie w pełni zautomatyzować, więcej na ten temat tutaj. @TinTours Zasobów do obsługi sprzedaży jeszcze nie wygaszamy. Nad wspomnianymi zasobami pracujemy i zasobów z tym związanych w WebAPI obecnie jeszcze nie wygaszamy.

[lukasnet]

Dlaczego wygaszacie metodę doVerifyItem? jak zatem zweryfikować aukcję wystawioną poprzez doSellSomeAgainInShop???

[PawelTaberski]

@lukasnet Zalecamy wystawianie ofert do wyczerpania zapasów i uzupełnianie stocku zgodnie ze stanem rzeczywistym. Zamiast korzystanie z tej metody.

[deneb-k]

Metoda doFinishItem pozwala odwołać złożone oferty kupna w licytacji. Jak to wygląda przy zamykaniu licytacji metodą offer-publication-commands? Oferty odwołają się z automatu?

[PawelTaberski]

@deneb-k Złożone oferty w licytacji przy zakończeniu jej przy pomocy zasobu /sale/offer-publication-commands/{commandId} nie są odwoływane.

[deneb-k]

Mam nadzieję, że macie to na liście rzeczy, które trzeba koniecznie dorobić przed czerwcem.

[PawelTaberski]

@deneb-k Przekazałem Twoją sugestię do odpowiedniego zespołu, jeśli zdecydujemy się wprowadzić taką zmianę poinformujemy o niej.

[PawelTaberski]

@lukasnet Zdecydowaliśmy obecnie jeszcze nie wygaszać metody doVerifyItem ze względu na jej użycie w doSellSomeAgain. Komunikat zaktualizowałem.

[FromAnyHole]

@PawelTaberski - wreszcie jakaś sensowna decyzja (doVerifyItem).

Podobnie powinniście podejść do innych KLUCZOWYCH metod: doChangeItemFields, doGetItemFields, doGetSellFormFieldsForCategory... (ta ostatnia metoda to była "nowość" - ZALECANA przez Was do niedawna) Nie wyobrażam sobie, aby te metody miały zniknąć przed wakacjami tego roku !! Koniecznie przesuńcie to wszystko na czas po wakacjach, wtedy są zwykle wdrożenia. p.s. Jak ktoś może nie wie albo "nie pamięta" - przez blisko dwa lata (od wakacji 2016 do czerwca 2018) utrzymywaliście oficjalnie, że "WebAPI pozostanie podstawowym interfejsem obsługowym w Allegro". Tak więc to Wy sami jesteście odpowiedzialni za całą dezinformację, zakładam tu tylko, że niezamierzoną ?!?

[deneb-k]

Dodam od siebie, że zamiast czekać na sugestie, sami musicie przejrzeć wszystkie funkcje udostępniane przez stare API i przeportować je w pełni do REST, zanim ubijecie SOAP (pomijając oczywiście rzeczy przeterminowane, jak obsługa opisów HTML). Z ostatnio omawianych przykładów: nie da się odwołać ofert w licytacjach przed ich zamknięciem, a usuwacie doFinishItem i nie da się sprawdzić w REST powodu zakończenia oferty.

To są tak podstawowe rzeczy, że mało komu przyjdzie do głowy pisać Wam, byście to zrobili. A później będzie "nikt nie pisał, że tego potrzebuje".

[FromAnyHole]

@deneb-k - dokładnie tak, próbuje się tu nas dalej traktować jak "testerów", a przy okazji tego przeskoku na API-REST - obciążyć dodatkowo odpowiedzialnością za to co się utrzyma (w dostępie) po zmianach, albo czego już w ogóle nie będzie, absurd jakiś... Ja widzę wiele rzeczy w tym REST, które traktuje jako ewidentne BUG'i - ale nie o wszystkim tu piszę, bo całe to REST traktuję nadal jako BETA-v. ;-)

[martacronic]

U mnie największym problemem jest to, że planowałam przenieść się z WebAPI na REST w całości, bez jednoczesnego łączenia do jednego i drugiego. Okazuje się, że będzie to niemożliwe, ponieważ np. zasób do dodawania numerów paczek ma być dodany do końca pierwszego kwartału 2019, a doGetItemsList usunięte zostanie w kwietniu. Korzystam intensywnie z obu metod.

Cieszyłam się na REST API i wyobrażałam sobie, że będę miała dostęp do tych samych danych co w WebAPI bez żadnych "Error Fetching http headers" i jeszcze cenniki i wielowariantowość.

Okazuje się, że mimo mnóstwa metod w REST do rzeczy, które nie są niezbędne typu obsługa tagów, nadal nie ma obsługi dodawania trackingów, (a jak wiadomo Allegro ma w zamiarze wymagalność 100%) oraz nawet nie wiadomo czy pojawi się cokolwiek do pobierania danych publicznych o aukcjach, co jest dla mnie bardzo istotne.

Podawanie dat wygaszania WebAPI w tej sytuacji mnie śmieszy, bo poważna firma powinna być w stanie wypuścić kompletne przetestowane narzędzie i dopiero wtedy zastanowić się nad datą wygaszania rozwiązanie, które chce porzucić.

Proszę w takim razie skoro się tak chwalicie terminami wygaszania WebAPI podać wiążący i ostateczny termin z Waszej strony udostępnienia kompletnego i przetestowanego REST API?

[FromAnyHole]

@martacronic - Wow !! To chyba najtrafniejszy komentarz w historii zmian ! Jakież to mamy fajne i mądre dziewczyny na pokładzie ;-)

[PawelTaberski]

Oczywiście po części wszyscy macie racje, idealnie by było jakby udało się nam wszystko w jednym momencie wdrożyć na REST przetestować pod każdym możliwym sposobem. Jednakże jest to niewykonalne, bo allegro ciągle żyje i zmienia się z dnia na dzień. Oprócz obecnie wdrożonych głównych funkcjonalności jak zarządzanie ofertami i sprzedażą wdrożyliśmy czego już nie było w WebAPI:

• zarządzanie cennikami,
• pole sygnatury/external.id,
• warunki ofert,
• tabele rozmiarów,
• punkty odbioru,
• drafty,
• i wiele innych mniejszych bądź większych funkcjonalności.

I przy każdej takiej operacji mieliśmy podwójną pracę bo musieliśmy pamiętać, aby nie spowodowało to większych problemów w WebAPI, aby ciągle działało. Ponadto obecnie na bieżąco musimy utrzymywać oba te środowiska, przejście w pełni choć z kilkoma głównymi funkcjonalnościami pozwoli nam mocniej się skupić nad wdrażaniem kolejnych zasobów w REST API i przyspieszy ten proces.

[FromAnyHole]

@PawelTaberski - i co w związku z tym wszystkim co powyżej ?? Czekamy na poważne podejście do sprawy, nie ma mowy o wygaszaniu przed wakacjami...

[pietrach]

Trzeba ten termin przesunąć na po wakacjach

[PawelTaberski]

Obecnie nie przewidujemy wydłużenia terminu. Niedawno zbieraliśmy informacje czego potrzebujecie, aby przejść sprawniej na REST API #1191 . Przeanalizujemy je i w ciągu tygodnia poinformujemy w tym poście czy, co i kiedy na ich podstawie zrobimy.

[FromAnyHole]

@PawelTaberski - tydzień minął...

Po raz kolejny należy jednak stwierdzić - wyłączenie z początkiem czerwca zestawu kluczowych metod WebAPI, głównie odpowiedzialnych za bieżącą obsługę oferty sprzedającego, NALEŻY PRZEŁOŻYĆ na termin po wakacjach (powiedzmy na 2.09.2019) !! To się inaczej wszystkim odbije poważnymi problemami - również Wam, a dodatkowy okres wakacyjny na wszelkie adaptacje się tu wszystkim należy, ponieważ przez blisko dwa lata wprowadzaliście nas w błąd - twierdząc, że WebAPI pozostanie podstawowym kanałem komunikacji. Wiecie doskonale, że tak pisaliście od sierpnia 2016, więc opamiętajcie się !!

[PawelTaberski]

Tak, jak pisałem wcześniej obecnie nie przewidujemy wydłużenia tego terminu. Już od 6 czerwca 2018 podawaliśmy terminy wygaszenia, które i tak już dla większości metod przedłużamy w stosunku do pierwotnego komunikatu o dwa miesiące.

[FromAnyHole]

@PawelTaberski - ale tydzień minął... A podane tu było cyt.: "(...) Przeanalizujemy je i w ciągu tygodnia poinformujemy w tym poście czy, co i kiedy na ich podstawie zrobimy."

[PawelTaberski]

@FromAnyHole Rozumiem, że chodzi Tobie o wątek #1191 wiem że trwają rozmowy co i kiedy jesteśmy w stanie wdrożyć i najdalej w przyszłym tygodniu pojawią się konkretne informacje z przewidywanymi terminami.

[sw69]

@PawelTaberski Podacie nam dokładną datę wyłączenia metod w SOAP? Piszecie, że numery do Inpost planujecie zrobić do końca marca, a metody w soap będziecie wyłączać w kwietniu. Musimy robić jakieś szpagaty, korzystać z dwóch api jednocześnie, w tym z jednego, które nie jest w pełni funkcjonalne. Sprawa z naszego punktu widzenia wygląda fatalnie. Nie wiadomo jak się do tego wszystkiego przygotować. Może Wy przygotujecie dla Nas wszystkich jakiś poradnik na najbliższy czas, z czego korzystać, jak i dlaczego? Dlaczego nie zrobicie tego jednym ruchem tj. nie przygotujecie dla nas działające rest api, a dopiero potem zabierzecie się za wygaszanie starego?

[PawelTaberski]

@sw69 W tym wątku zbieraliśmy informacje co jest niezbędne dla Was do płynnego przejścia na REST API #1191 i już niedługo opublikujemy tam informacje co i w jakim czasie jesteśmy w stanie dostarczyć. Odnośnie Twojego pytania wygaszamy metody, które maja już swoje odpowiedniki na REST API, ponadto metody w WebAPi nie mają już pełnego zakresy funkcjonalności jakie daje REST API w tym zakresie m.in. nie pozwalają wstrzymać oferty, zarządzać i dodać cennik i wiele innych.

[neldh]

Czy w kwietniu wygaśnie tylko metoda doGetItemsList czy będą w kwietniu wygasać jeszcze jakieś inne metody?

Tutaj jest mowa niby tylko o doGetItemsList, ale wcześniejszy news glosił:

"W kwietniu 2019 usuwamy metody do obsługi oferty i zamówień:

doGetPostBuyData
doGetPostBuyFormsDataForSellers
doGetPostBuyFormsIds 
doGetTransactionsIDs
doMyContact
doGetSiteJournalDeals
doGetSiteJournalDealsInfo
doChangeItemFields
doChangePriceItem
doChangeQuantityItem
doFinishItem
doFinishItems
doGetShipmentData
doGetItemFields
doCheckItemDescription
doCheckNewAuctionExt
doGetSellFormFieldsForCategory
doNewAuctionExt
doVerifyItem

" z kolei tutaj piszecie, że część z tych metod będzie działać aż do czerwca. Co z pozostalymi, nie wymienionymi w tym wątku, np: doGetPostBuyData, doGetPostBuyFormsDataForSellers ?

Czy to oznacza, że niewymienione metody (jak doGetPostBuyData, doGetPostBuyFormsDataForSellers) przetrwają co najmniej do czerwca, czy nie? Pogubić się idzie... Niby te metody co wymieniłem nie mają deprecated, więc w pierwszej chwili sądzilem, że dalej będą w kwietniu działać, ale wolę mieć pewność

[PawelTaberski]

Tak w kwietniu wygaszamy tylko doGetItemsList, wszelkie daty wygaszenia metod znajdziesz także przy danej metodzie w dokumentacji.

[aktywnitu]

Tak w kwietniu wygaszamy tylko doGetItemsList, wszelkie daty wygaszenia metod znajdziesz także przy danej metodzie w dokumentacji.

A czy jest odpowiednik do doGetItemsList w REST API, który pozwoli na pobranie szczegółowych danych na temat publicznych ofert?

[aktywnitu]

Harmonogram dla REST API - Luty/Marzec 2019 ... wspólnie z InPostem rozwiążemy problem integracji związany z nowymi numerami zamówień.

Przypominam - porozmawiajcie w końcu porządnie z InPostem.

[PawelTaberski]

@aktywnitu Tak mamy odpowiednik doGetItemsList jest nim zasób GET /offers/listing , który odzwierciedla działanie wyszukiwarki na froncie. Odnośnie inpostu cały czas pracujemy wspólnie nad tą kwestią.

[deneb-k]

@deneb-k Przekazałem Twoją sugestię do odpowiedniego zespołu, jeśli zdecydujemy się wprowadzić taką zmianę poinformujemy o niej.

I coś wiadomo w sprawie odwoływania ofert? To chyba jedyna rzecz, której mi do szczęścia potrzeba, by zrezygnować z doFinishItem.

[PawelTaberski]

Nie mam informacji abyśmy mieli to wdrożyć w najbliższym czasie, tak jak pisałem sugestię opisałem zgodnie z Twoimi oczekiwaniami i przekazałem. Jeśli otrzymam informacje, że wdrażamy takie rozwiązanie to przygotujemy dedykowany komunikat.

[Maczuga]

Co z tym InPostem? Niektórzy czekają już ładnych parę miesięcy, termin wygaszenia starych metod mija nieubłaganie, ludzie czekają z przenosinami aż będą dostępne wszystkie potrzebne rzeczy. Nie każdy ma czas żeby nagle wcisnąć przepisywanie integracji z WebAPI na REST + przetestowanie wszystkiego na miesiąc przed terminem.

[PawelTaberski]

Rozmowy z InPostem trwają jak tylko uda nam się dokonać zmian poinformujemy o tym.

[aktywnitu]

Długo rozmawiacie. Programiści tacy rozmowni zwykle nie są. Proszę trzymać się terminów. Mamy Kwiecień i jeszcze się nie dogadaliście. Może lepiej nie gadać tyle, tylko udostępnić programistom konwerter id zamówienia w restapi na integer, a resztą niech InPost sam ogarnia.

[deneb-k]

Akurat jeśli idzie o InPost, to z doświadczenia wiem, że rozmowy z nimi o czymkolwiek zawsze tyle trwają, więc tu pretensji do Allegro bym nie miał ;)

[FromAnyHole]

13 kwietnia, nadal NIC konkretnie nie wiadomo na temat zmian i wygaszania WebAPI. Chyba trzeba będzie Wam jednak jakiś protest urządzić pod siedzibą w poznaniu...

[PawelTaberski]

Tak jak pisałem rozmowy z InPost-em trwają jak tylko będziemy znali dokładną datę to poinformujemy o tym.

[Maczuga]

To chociaż ze swojej strony oszczędźcie ludziom nerwów i przesuńcie termin migracji na REST API z czerwca na wrzesień, bo jak te rozmowy będą się w takim tempie toczyć to do nowego roku się integracji z InPostem nie doczekamy, a znając ich to bardzo możliwe (sam kiedyś czekałem z miesiąc na rozwiązanie mojego problemu w InPost).

[aktywnitu]

Zanim Inpost ogarnie temat, Allegro mogłoby wprowadzić jakieś rozwiązanie tymczasowe.

[PawelTaberski]

@Maczuga @aktywnitu Najprawdopodobniej w maju InPost wprowadzi rozwiązanie tego problemu, czekam jeszcze na potwierdzenie. Jak tylko będziemy mieć pewne informacje, to poinformujemy o tym w dedykowanym komunikacie.

[FromAnyHole]

https://github.com/allegro/allegro-api/issues/1534

[kfijalko]

Panie i Panowie, napier... ostro, znaczy się koduję ;) Niestety 3 czerwca poleje się krew niewinnych ofert ;) Czy termin 3 czerwca jest nadal w mocy czy może statystyki użycia resta nie pozwalają jeszcze na przejście ?? (mam taką cichą nadzieję) @PawelTaberski

[MartaNowaczyk]

@kfijalko 3 czerwca nadal w mocy

[Maczuga]

A jak idzie ponaglanie InPostu? Wyrobią się oni do 3 czerwca, czy po tym terminie dalej trzeba będzie korzystać z 2 API?

[MartaNowaczyk]

@Maczuga prace trwają i jest szansa, że nie będzie trzeba korzystać z 2 API.

[PatrykTrena]

Dzień dobry, Czy coś już wiadomo na temat Inpostu, ponieważ trochę to już trwa i nic.

@Maczuga prace trwają i jest szansa, że nie będzie trzeba korzystać z 2 API.

[MartaNowaczyk]

@PatrykTrena jesteśmy w fazie testów. O ile nic po drodze złego się nie wydarzy, to najbliższy możliwy termin to przyszły tydzień. Tak jak już pisałam w innym wątku, nie chcę pisać konkretnej daty, bo nie zależy ona tylko od nas, a chcę uniknąć kolejnych rozczarowań.