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.

15 lutego 2019 r.

Komunikaty techniczne

[Zapowiedź] 18.03.2019 - zmiany w metodach doShowItemInfoExt i doGetItemsInfo / [Announcement] 18 March 2019 - changes in doShowItemInfoExt and doGetItemsInfo

18 marca 2019 zmienimy wartości niektórych pól zwracanych przez doShowItemInfoExt i doGetItemsInfo. Poniżej możecie zobaczyć, co zmieni się dla danego pola oraz jaki jest powód zmiany:

Pole
Przed zmianą
Po zmianie
Powód zmiany
itHitCount
stan licznika
odwiedzin na ofercie
zawsze 0
od dłuższego czasu licznik wyświetleń nie jest widoczny w ofercie
itHighBidder
0 lub id kupującego
zawsze 0
od dłuższego czasu informacje o konkretnych kupujących nie są widoczne w ofercie
itHighBidderLogin
login kupującego w formie zanonimizowanej lub pełny login
zawsze pusty string
od dłuższego czasu informacje o konkretnych kupujących nie są widoczne w ofercie
itStandardizedDescription
nowy opis oferty jako sekcja CDATA lub w formie zakodowanej
nowy opis oferty zawsze
jako sekcja CDATA czyli:
<![CDATA[{"sections":[{"items":[{"type":"TEXT","content":"<p> … ]]>
chcemy uspójnić format danych zwracanych w tym polu
itIsForGuests
Informacja o tym, czy zakupu mogą dokonać użytkownicy bez rejestracji (1 - mogą, 0 - nie mogą)
zawsze 1
to pole nie jest obsługiwane


On 18 March 2019 we will change values of some fields returned by doShowItemInfoExt i doGetItemsInfo. Below you will find detailed information concerning the change and its reason:

Field
Before change
After change
Reason
itHitCount
visit counter
always 0
the counter is not presented on the offer page for some time now
itHighBidder
0 or buyer ID
always 0
information on particular buyers is not presented on the offer page for some time
itHighBidderLogin
buyer’s login in the anonymized form or full login
always empty string
information on particular buyers is not presented on the offer page for some time
itStandardizedDescription
new description of an offer as a CDATA section or in the encoded form
new description of an offer always as a CDATA section, i.e.:
<![CDATA[{"sections":[{"items":[{"type":"TEXT","content":"<p> … ]]>
we want to standardize the form of returned data
itIsForGuests
information whether unregistered users can make a purchase (1 – yes, 0 – no).
always 1
that field is not available

Podyskutuj o zmianach na forum usługi

30 stycznia 2019 r.

Komunikaty techniczne

Ujednolicimy dane metod dostawy \ Changes in the data of delivery methods

Changes in the data of delivery methods

  • 4.02.2019 we will change the names of delivery methods in REST API and WebAPI
    • in Allegro API we will use the same names of delivery methods
    • the names will be better presented in mobile applications, because many of them will be shorter
  • Because of that changes:


  • 28.02.2019 we will change the maximum values for shipping methods in REST API and WebAPI.
  • Because of that in Allegro API we will use the same maximum values for shipping methods in the Allegro API.

 


Changes in the data of delivery methods

  • 4.02.2019 we will change the names of delivery methods in REST API and WebAPI
    • in Allegro API we will use the same names of delivery methods
    • the names will be better presented in mobile applications, because many of them will be shorter
  • Because of that changes:


  • 28.02.2019 we will change the maximum values for shipping methods in REST API and WebAPI.
  • Because of that in Allegro API we will use the same maximum values for shipping methods in the Allegro API.

Podyskutuj o zmianach na forum usługi

21 stycznia 2019 r.

Komunikaty techniczne

21 lutego 2019 usuniemy metodę dostawy odbiór osobisty - zastąp ją odbiorem osobistym w punkcie sprzedawcy / February 21, 2019 we will remove the delivery method self-pickup - replace it with a seller pick-up point

21 lutego 2019 usuniemy metodę dostawy odbiór osobisty - zastąp ją odbiorem osobistym w punkcie sprzedawcy

21.02.2019 r. usuniemy metodę dostawy “Odbiór osobisty”. Do tego czasu zastąp ją nową metodą "Odbiór osobisty w punkcie sprzedawcy”. Dzięki zmianie:

  • punkty odbioru osobistego sprzedawcy wyświetlimy na mapie, którą klient widzi w procesie zakupowym
  • informacja o punkcie jaki wybierze klient:
  • klient nie będzie mógł zamówić z płatnością przy odbiorze do punktu, który nie ma takiej możliwości.

Jak włączyć odbiór osobisty, który klient będzie mógł wybrać z mapy:

Przy pomocy metody DoChangeItemFields przypisz do swoich ofert nową metodę dostawy. Jednocześnie pamiętaj, aby usunąć fid 35 - “Darmowe opcje przesyłki”.

Ważne! Punkty odbioru osobistego możesz dodać przy pomocy dedykowanego zasobu /points-of-service. Zadbaj o komplet informacji na temat punktu, w którym klient może odebrać przesyłkę.

 


 

February 21, 2019 we will remove the delivery method self-pickup - replace it with a seller pick-up point

February 21, 2019 we will remove the delivery method self-pickup. Until then, replace it with a new method "Seller pick-up point”. Thanks to the change:

  • we will display the seller pick-up point on the map that customer sees in the purchase process
  • information about the selected by customer pickup point, we will:
    • provide in the mail
    • return through Allegro API in resources to orders management
    • show in my allegro to the customer in the purchased
    • show in my allegro to the seller in the orders
  • the customer will not be able to order with on delivery payment to a point that do not have this form of payment.

How to enable seller pick-up point, which customer will be able to choose from the map:

Use the DoChangeItemFields method to assign new delivery method to your offers. remember to remove fid 35 - "Free delivery options".

Note! You can add pick-up points using method /points-of-service. Complete all information about the point at which the customer can pick up the order.

 

Podyskutuj o zmianach na forum usługi

17 stycznia 2019 r.

Komunikaty techniczne

Nowe metody dostawy - Odbiór osobisty w punkcie sprzedawcy / New delivery methods - Seller pick-up point

Udostępniliśmy nowe metody dostawy. Identyfikatory nowych metod możesz uzyskać zasobem doGetShipmentData , bądź doGetSellFormFieldsForCategory

Odbiór osobisty w punkcie sprzedawcy - fidy: 

  • 404 (pierwsza sztuka), 
  • 504 (kolejna sztuka), 
  • 604 (ilość w paczce)
Odbiór osobisty w punkcie sprzedawcy pobranie - fidy: 
  • 405 (pierwsza sztuka), 
  • 505 (kolejna sztuka), 
  • 605 (ilość w paczce)

 


We have introduced new delivery methods. You can get identifiers in the resource doGetShipmentData or doGetSellFormFieldsForCategory

Seller pick-up point - fids: 

  • 404 (first item), 
  • 504 (next item), 
  • 604 (quantity in a packet)
Seller pick-up point (CASH_ON_DELIVERY) - fids: 
  • 405 (first item),
  • 505 (next item),
  • 605 (quantity in a packet).

Podyskutuj o zmianach na forum usługi

9 stycznia 2019 r.

Organizacyjne

Wygaszamy WebAPI do obsługi ofert i sprzedaży. Korzystaj z REST API / End of WebAPI support – offer and sales management. Use REST API

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ą:

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.


O planach dla innych metod i zasobów w API będziemy informować na bieżąco. W razie pytań zachęcamy do kontaktu.


 

As of August 2016, you can connect to Allegro using two API protocols, i.e. REST and SOAP. The one we focus on is REST API that supports all new functionalities we add. Recently, we have introduced a set of REST API resources you can use to::

Plans for Allegro API

We focus on REST API

We would like to remind you that the resources that allows list and edit the offer are public version from September 2018.

REST API schedule - February / March 2019

  • Product-based shopping experience – grouping offers presenting the same product
    • we will introduce resources for assigning new and existing offers to products from our base. The resources will be introduced as beta versions to test them and collect your feedback.
    • At the same time, we are working on resources that will let you add products to our base.
  • resources for managing orders will be available as public. As we are open to your suggestions and comments, we invite you to test the beta resources
  • new resources for adding information about the parcel
  • together with InPost we will work on integration issues related to new order numbers.

Phasing out WebAPI

WebAPI is an old solution we maintain owing to backward compatibility with current applications. However, we are no longer working on it and we will eventually deactivate it.


We will inform you about plans concerning other API methods and resources on a regular basis. Should you have any questions, contact us.

Podyskutuj o zmianach na forum usługi

4 stycznia 2019 r.

Komunikaty techniczne

11 stycznia 2019 usuniemy nieużywane metody WebAPI / January 11, 2019 we will remove unused WebAPI methods

11 stycznia 2019 usuniemy nieużywane metody WebAPI:
  • doCancelTransaction - anulowanie płatności Allegro Finanse
  • doGetMyAddresses - pobieranie zapisanych na koncie użytkownika danych adresowych
  • doGetShipmentDataForRelatedItems - pobieranie wspólnych sposobów dostawy dla podanych ofert
  • doGetMyPaymentsRefunds - pobieranie listy zwrotów zalogowanego użytkownika
  • doGetArchiveRefundsList - pobieranie listy złożonych wniosków o zwrot prowizji do ofert archiwalnych
  • doCancelRefundWarning - anulowanie ostrzeżeń
  • doRequestSurcharge - obsługa żądań dopłat do niekompletnej płatności
  • doSendPostBuyForm - wypełnienie i wysłanie formularza pozakupowego
  • doGetRelatedItems - pobieranie powiązanych ofert, dla których ma być wypełniony formularz dostawy

January 11, 2019 we will remove unused WebAPI methods:
  • doCancelTransaction - canceling Allegro Finance payment
  • doGetMyAddresses - loading information on address data saved on user account
  • doGetShipmentDataForRelatedItems - loading common delivery methods for the selected offers
  • doGetMyPaymentsRefunds - loading list of refunds for logged-in user
  • doGetArchiveRefundsList - retrieving a list of submitted commission refund forms for archived offers
  • doCancelRefundWarning - warning cancellation
  • doRequestSurcharge - processing requests for additional payments due to incomplete payments
  • doSendPostBuyForm - completing and sending the after-sale form
  • doGetRelatedItems - loading related offers to have their after-sale form filled out

Podyskutuj o zmianach na forum usługi

3 stycznia 2019 r.

Komunikaty techniczne

Przerwa techniczna / Technical break

9 stycznia od godziny 01:00 do 05:00 serwis będzie niedostępny.
Nie będzie również możliwości skorzystania z API Allegro.


9 January from 01:00 to 05:00 the service will be unavailable.
You will also not be able to use Allegro API.

Podyskutuj o zmianach na forum usługi

2 stycznia 2019 r.

Komunikaty techniczne

Problem z WebAPI allegro

W dniu dzisiejszym od 12:20 do 13:30 występował problem z Allegro WebAPI.


Today, from 12:20 to 13:30 there was a problem with Allegro WebAPI.

Podyskutuj o zmianach na forum usługi

12 grudnia 2018 r.

Komunikaty techniczne

doGetItemsInfo - ograniczamy wielkość tablicy z identyfikatorami ofert / doGetItemsInfo - we limit the size of the table with the offer identifiers

Zgodnie z zapowiedzią, od dziś metodą doGetItemsInfo wyślesz nie więcej niż 10 identyfikatorów ofert. Tablica identyfikatorów ofert itemsIdArray może przyjąć maksymalnie 10 wartości.

Dzięki zmianie chcemy zapewnić szybszy czas odpowiedzi i zwiększyć stabilność działania metody.

 


 

As announced, from today in method doGetItemsInfo you will send no more than 10 offer IDs. The itemIdArray will take no more than 10 offer ID's.

We want to provide a faster response time and increase the stability of the method.

Podyskutuj o zmianach na forum usługi

10 grudnia 2018 r.

Organizacyjne

Nowe metody dostawy - Dostawa przez sprzedającego / New delivery methods - Delivery by the seller

Udostępniliśmy nowe metody dostawy. Identyfikatory nowych metod możesz uzyskać zasobem doGetShipmentData , bądź doGetSellFormFieldsForCategory

Dostawa przez sprzedającego - fidy: 

  • 406 (pierwsza sztuka), 
  • 506 (kolejna sztuka), 
  • 606 (ilość w paczce)
Dostawa przez sprzedającego płatność przy odbiorze - fidy: 
  • 407 (pierwsza sztuka), 
  • 507 (kolejna sztuka), 
  • 607 (ilość w paczce)

 


We have introduced new delivery methods. You can get identifiers in the resource doGetShipmentData or doGetSellFormFieldsForCategory

Delivery by the seller- fids: 

  • 406 (first item), 
  • 506 (next item), 
  • 606 (quantity in a packet)
Delivery by the seller payment on delivery - fids: 
  • 407 (first item),
  • 507 (next item),
  • 607 (quantity in a packet).

Podyskutuj o zmianach na forum usługi