Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

[NEWS] Harmonogram wygaszania WebAPI Allegro #1682

Open
TomekKaczmarek opened this issue May 24, 2019 · 15 comments

Comments

Projects
None yet
7 participants
@TomekKaczmarek
Copy link
Collaborator

commented May 24, 2019

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 etapowo wyłączamy.

Kolejne metody w WebAPI będziemy stopniowo wygaszać do końca kwietnia 2020 roku - wtedy planujemy całkowicie wyłączyć ten interfejs. Równolegle będziemy udostępniać nowe zasoby w REST API, by integracja była możliwa tylko przez nowe API.

Przygotowaliśmy artykuł, w którym znajdziesz informacje:

  • kiedy i jakie zasoby wyłączymy w WebAPI
  • kiedy i jakie odpowiedniki tych procesów udostępnimy w REST API.

@TomekKaczmarek TomekKaczmarek self-assigned this May 24, 2019

@TomekKaczmarek TomekKaczmarek pinned this issue May 24, 2019

@FromAnyHole

This comment has been minimized.

Copy link

commented May 24, 2019

@TomekKaczmarek - czyli tylko Wasze plany są ważne, żenada...
Wasz zespół kilkudziesięciu osób od 3 lat pracuje - zresztą ogłaszając po kawałku to i owo - nad całkiem nowym systemem API, no i jeszcze zajmie Wam to pewnie kolejne dwa lata. A od pojedynczych osób czy 2-3 osobowych projektów wymagacie, że ktoś to teraz w kilka miesięcy przeanalizuje, zaprojektuje na nowo swoje rozwiązania i oprogramuje / przetestuje i wdroży ??? Stuknijcie się mocno w głowę !!
p.s.
Co by się takiego u Was "zawaliło", gdyby przełożone zostały wygaszenia z początku czerwca ?

@TomekKaczmarek

This comment has been minimized.

Copy link
Collaborator Author

commented May 24, 2019

@FromAnyHole

Zmiany zapowiedzieliśmy z ogromnym wyprzedzeniem - niemal rok temu. Teraz publikujemy cały harmonogram, żeby tym bardziej można było zaplanować prace nad migracją.

Allegro dynamicznie się rozwija, pojawia się wiele nowych opcji, które również będziemy udostępniać w REST API. Rzetelna intrgacja to nie tylko przejście na REST API z procesami, które są dostępne w WebAPI. To również ciągła i aktualna praca nad uzupełnianiem rozwiązania o nowe opcje dostępne w Allegro. Czasy, w których można było napisać integrację raz i mieć na lata święty spokój bezpowrotnie minęły.

Aktualne dane wskazują, że większość rozwiązań korzystających z API zdąży się przepiąć na nowe rozwiązanie. Na ten moment nie planujemy przekładać terminu wygaszenia metod ofertowych.

@FromAnyHole

This comment has been minimized.

Copy link

commented May 24, 2019

@TomekKaczmarek - ale pytam ponownie:
Co by się "zawaliło", gdyby termin wygaszania był po wakacjach ??
Czytacie w ogóle to, co gremialnie ludzie sądzą i piszą, polecam:
#1597
Żadnych refleksji - zupełnie NIC ?????

@TomekKaczmarek

This comment has been minimized.

Copy link
Collaborator Author

commented May 24, 2019

@FromAnyHole refleksja jest taka sama, jak przy każdej innej zmianie, którą wprowadzimy w serwisie. Przy tak dużej liczbie użytkowników (sprzedawców, integratorów), zawsze jest grupa, która nie zdąży, nie wyrobi się, narzeka na termin.

Wieloletnie doświadczenie nauczyło nas, że przesuwanie terminu niczego nie rozwiązuje. Bo na kolejny termin również są tacy, którzy nie zdążą, nie wyrobią się i narzekają.

Z naszej strony sytuacja była czysta, informacje o tym kiedy i co się zadzieje podaliśmy z ogromnym wyprzedzeniem. Czasu na przetestowanie i przygotowanie integracji było wystarczająco dużo. Na ten moment podtrzymujemy decyzję, że terminu nie przesuniemy.

@FromAnyHole

This comment has been minimized.

Copy link

commented May 24, 2019

@TomekKaczmarek - aha, czyli NIC zupełnie by się nie "zawaliło", tylko chcecie postawić "na swoim" dla jakiejś głupiej czy wymyślonej nagle zasady. A to nie jest przecież taka sytuacja, że dopóki czegoś nie wyłączycie, to niemożliwe są inne rzeczy - proszę więc nie wciskać kitu ludziom...

@martacronic

This comment has been minimized.

Copy link

commented May 24, 2019

@TomekKaczmarek piszesz tak jakbyście niemal rok temu oddali w nasze ręce kompletne REST API z metodami w wersji public, a grupa leniwych developerów nie zabrała się za migracje.

Co nam po informacji rok temu, że wygaszacie, skoro nie było nad czym pracować, bo metody w REST API nie były dostępne. Sama czekałam na wszystkie potrzebne mi metody, żeby nie musieć w ramach jednej aplikacji utrzymywać i WebAPI i REST API. Nie doczekałam się i metoda POST /order/checkout-forms/{checkoutForm.id}/shipments, która była mi niezbędna weszła 19.02 i moja aplikacja hula sobie nie niej w wersji beta, bo nie mogę wysyłać trackingu na podstawie nowego REST API metoda z WEB API, bo numery zamówień mają inny format. Nie czuję się z tym komfortowo.

Jest to zatem wybitnie nie na miejscu zaklinać rzeczywistość i twierdzić, że daliście nam czas. Rok to moglibyście liczyć od momentu jak skończycie przepisywać funkcjonalności do REST API. W jakimś wątku pytałam o ten termin, to okazało się, że jest on nieokreślony.

Resumując: Web wygaszamy, gdy Rest jeszcze nie mamy.

@FromAnyHole

This comment has been minimized.

Copy link

commented May 24, 2019

Albo po kiego nagle wyłączacie teraz metodę [doGetSellFormFieldsForCategory], jak zupełnie niedawno sami robiliście WIELKĄ AKCJĘ zachęcania, a potem konieczność korzystania z tego - pamięć Wam odebrało ???
Powinniście to https://allegro.pl/webapi/documentation.php/show/id,782 wyłączać razem z innymi elementami WebAPI, które są odpowiedzialne za obsługę kategorii ! Co sensownie zastępuje tą metodę w REST - napisze Pan może ?? Jest w jakimś jednym zasobie, a w wersji Beta do kiedy było w kawałkach ??

@neldh

This comment has been minimized.

Copy link

commented May 24, 2019

Zmiany zapowiedzieliśmy z ogromnym wyprzedzeniem - niemal rok temu. Teraz publikujemy cały harmonogram, żeby tym bardziej można było zaplanować prace nad migracją.

To nie jest żaden argument w sytuacji, gdy dopiero kończycie właśnie zamienniki wygaszanych metod. Owszem. Fajnie, że z wyprzedzeniem o tym poinformowaliście, ale każdy liczył na to, że część REST odpowiedzialna za to co robiły w WEBAPI wygaszane metody będzie do tego czasu profesjonalnie ogarnięta...

Fajnie, że spora część devów zdąży z integracją, bo pewnie te niedokończone rzeczy nie są im potrzebne, ale takie zachowanie jest dalekie od profesjonalizmu.

@Maczuga

This comment has been minimized.

Copy link

commented May 24, 2019

@TomekKaczmarek Jak to jest, że swoim użytkownikom potraficie postawić sztywny termin wygaszenia, podczas gdy InPost leci sobie w ciula od ponad pół roku? #872 - już tutaj było pisane, że "Trwają rozmowy z Inpostem w sprawie rozwiązania tej sytuacji". Skoro taki InPost nie może w pół roku ogarnąć integracji tego po swojej stronie, to skąd oczekiwania, że każda inna firma będzie w stanie? 3 czerwca koniec wsparcia dla głównych metod dotyczących ofert. Soft, który będzie się z wami komunikował będzie jakimś plugastwem złożonym z 2 niekompletnych API, które nawet razem nie stanowią spójnej formy.

Mało tego - #1217 (comment) - tutaj piszecie, że planowana integracja z InPost jest na luty/marzec - mamy koniec maja, co daje 2 i pół miesiąca poślizgu.

@TomekKaczmarek

This comment has been minimized.

Copy link
Collaborator Author

commented May 24, 2019

@FromAnyHole
Nie wiem na jakiej podstawie uważasz, że nic by się nie zawaliło. Wydaje mi się, że lepiej znamy wpływ poszczególnych elementów na naszą platformę.

Masz też oczywiście prawo twierdzić, że zasady ustalone na podstawie wieloletniego doświadczenia w wprowadzaniu dużych zmian, są głupie. Nie wpłynie to jednak na naszą decyzję.

Odnośnie doGetSellFormFieldsForCategory - to zalecenie, o którym wspominasz publikowaliśmy niemal rok (2017-09-26) przed zapowiedzią wyłączenia oferty w WebAPI (2018-06-06).

W REST API odpowiedniki są na poziomie procesów (wystawianie ofert, pobieranie danych o zamówieniach), a nie na poziomie metod. Jeśli chcesz się dowiedzieć, jak uzyskać pola, które musisz podać, by wystawić ofertę zapoznaj się z tym poradnikiem.

@martacronic
Nigdy nie twierdziliśmy, że zmiana będzie zerojedynkowa. Jak każda duża zmiana, tak i ta jest procesem rozłożonym w czasie. Na tym etapie udostępniamy API Allegro w dwóch interfejsach, z których trzeba korzystać równolegle. Zdecydowana większość integratorów radzi z tym sobie.

Wyłączamy w tej chwili ofertę, wskazujesz na problemy w zamówieniach, które faktycznie na tym etapie są jeszcze w wersji beta i wymagają poprawek. Dlatego wyłączenie zamówień w WebAPI zaplanowaliśmy na styczeń 2020.

Zarządzać ofertami w REST API w wersji public możesz od września 2018 roku - od 8 miesięcy.
Oczywiście moglibyśmy podejść waterfallem, latami pracować nad kompletnym REST API i go opublikować od razu w całości. Efekt byłby taki, że już w momencie publikacji nowe API mogłoby nie być aktualne - pojawiałyby się w nim zmiany i narzekania, że przecież ledwo się nowe API pojawiło już je zmieniacie. Dlatego - tak jak rozwija się rynek i tak jak rozwijamy serwis, tak i tę zmianę realizujemy stopniowo.

@neldh
Zarządzać ofertami w REST API w wersji public możesz od września 2018 roku. W REST API odpowiedniki są na poziomie procesów (wystawianie ofert, pobieranie danych o zamówieniach), a nie na poziomie metod. Jeśli chcesz się dowiedzieć, jak wystawić ofertę w REST API zapoznaj się z tym poradnikiem.

@Maczuga
Poruszasz temat niezwiąznay z zarządzaniem ofert. Inpost jest osobną firmą, na którą nie mamy bezpośredniego wpływu. W temacie, który zgłaszasz działamy, ale nie jest zależny od nas.

@pijablonski

This comment has been minimized.

Copy link

commented May 24, 2019

InPost do przesyłek typu Allegro wymaga numeru, którego przez REST API nie udostępniacie. Zmiana formatu numeru płatności jest decyzją Allegro, nie InPostu. Od co najmniej 8 lutego (sic!) obiecujecie, że "Allegro wspólnie z InPost rozwiąże ten problem". Od ponad 3 miesięcy problem z jednym numerem! Przecież jeden zasób typu mapowanie rozwiązałby sprawę.

Stawiacie pod murem wszystkie integracje, które zostały przygotowane do jednoczesnego przejścia z webapi na REST API dla obsługi aukcji oraz zamówień - albo wystawianie aukcji, albo integracja z InPost, Naprawdę nie widzicie problemu?

Edit: Nie oczekuję wiele - wystarczy kilka dni od udostępnienia przez REST API wszystkich danych potrzebnych do zakładania przesyłek do wyłączenia obsługi wystawiania/edycji aukcji przez web api.

@FromAnyHole

This comment has been minimized.

Copy link

commented May 24, 2019

@TomekKaczmarek - Panie Szanowny, Wy przecież TERAZ i to często na wariackich papierach - dopinacie dopiero najróżniejsze rzeczy w tym Beta-REST, więc najważniejsze pytanie brzmi:

  • dlaczego wbrew większości sugestii użytkowników, gdzie pisane było wielokrotnie o luźniejszym czasie wakacyjnym i możliwościach adaptacji i wdrożeń tylko w tym okresie, zabieracie wielu osobom CHLEB ??
@TomekKaczmarek

This comment has been minimized.

Copy link
Collaborator Author

commented May 27, 2019

@pijablonski metody do obsługi zamówień planujemy wyłączyc dopiero w styczniu 2020. Zmian z WebAPI na REST API zalecamy realizować stopniowo. Jesteśmy na etapie wygaszania metod do ofert - tak jak rozwija się rynek i tak jak rozwijamy serwis, tak i tę zmianę realizujemy stopniowo. Z Inpostem jesteśmy w kontakcie, staramy się rozwiązać ten problem.

@FromAnyHole póki co mówimy o zarządzaniu ofertami - te zasoby są w wersji public od jakiegoś czasu i są gotowe, by zastąpić WebAPI. W REST udostępniamy wiele funkcji, których w WebAPI nie ma (cenniki dostawy, tabele rozmiarów, zmiana ceny w ofercie z zakupem, sekcja Pasuje do, produktyzacja, wznowienie oferty po zakończeniu, etc.). Termin już przekładaliśmy, aktualne dane wskazują, że proces przepinania postępuje sprawnie lub zakończył się u wielu integratorów, dlatego na ten moment nie planujemy przełożyć terminu.

@joe1d83

This comment has been minimized.

Copy link

commented Jun 14, 2019

Czy w REST API planujecie wprowadzić odpowiedniki
metod do zarządzania czarną listą ?

@TomekKaczmarek

This comment has been minimized.

Copy link
Collaborator Author

commented Jun 17, 2019

@joe1d83 tak - umieściliśmy je w harmonogramie.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
You can’t perform that action at this time.