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.
doBidItem
Metoda pozwala na złożenie oferty kupna w trwającej ofercie.
Metoda pozwala na złożenie oferty kupna w trwającej ofercie.
- session-handle | string | wymagany
Identyfikator sesji użytkownika, uzyskany za pomocą metody doLogin(Enc). - bid-it-id | long | wymagany
Identyfikator oferty, w której ma zostać złożona oferta kupna. - bid-user-price | float | wymagany
Oferowana kwota (dla ofert z licytacją). Dla ofert typu Kup Teraz!, w polu przekazana musi zostać kwota równa kwocie KT ustalonej przez sprzedającego, zgodna z widoczną w trwającej ofercie. - bid-quantity | long | wymagany
Liczba przedmiotów, której dotyczy składana oferta (także w przypadku oferty wielowariantowej). - bid-buy-now | long | niewymagany (wymagany dla ofert typu Kup Teraz!)
Informacja o tym, czy w ofercie (która musi mieć taki format zakupu dostępny) zakup ma być dokonany przez Kup Teraz! (1 - tak, 0 - nie). Domyślną wartością jest 0. - pharmacy-recipient-data | PharmacyRecipientDataStruct | niewymagany
Struktura zawierająca dane adresowe kupującego leki (dot. kategorii: Zdrowie i Uroda > Leki bez recepty; wypełnienie struktury przy zakupie w kategorii innej niż wskazana, spowoduje że dane w niej przekazane będą ignorowane).- recipient-first-name | string | niewymagany
Imię kupującego leki. - recipient-last-name | string | niewymagany
Nazwisko kupującego leki. - recipient-address | string | niewymagany
Adres kupującego leki. - recipient-postcode | string | niewymagany
Kod pocztowy kupującego leki. - recipient-city | string | niewymagany
Miasto, w którym mieszka kupujący leki.
- recipient-first-name | string | niewymagany
- variant-id | string | niewymagany (wymagany dla ofert z kategorii obsługujących oferty wielowariantowe. Ich lista jest dostępna w naszym FAQ)
Identyfikator kupowanego wariantu, uzyskany za pomocą metody doShowItemInfoExt.
Orientacyjna struktura wywołania metody
$dobiditem_request = array(
'session-handle' => '22eb99326c6be29aa16d07d622bcfbcbee94ad54846f2f4e03_1',
'bid-it-id' => 1086438628,
'bid-user-price' => 15.00,
'bid-quantity' => 1,
'bid-buy-now' => 0,
'pharmacy-recipient-data' => array()
'variant-id' => '22eb99326c6be29aa16d07d622bcfbcbee94ad5',
);
- sessionHandle | string | wymagany
Identyfikator sesji użytkownika, uzyskany za pomocą metody doLogin(Enc). - bidItId | long | wymagany
Identyfikator oferty, w której ma zostać złożona oferta kupna. - bidUserPrice | float | wymagany
Oferowana kwota (dla ofert z licytacją). Dla ofert typu Kup Teraz!, w polu przekazana musi zostać kwota równa kwocie KT ustalonej przez sprzedającego, zgodna z widoczną w trwającej ofercie. - bidQuantity | long | wymagany
Liczba przedmiotów, której dotyczy składana oferta (także w przypadku oferty wielowariantowej). - bidBuyNow | long | niewymagany (wymagany dla ofert typu Kup Teraz!)
Informacja o tym, czy w ofercie (która musi mieć taki format zakupu dostępny) zakup ma być dokonany przez Kup Teraz! (1 - tak, 0 - nie). Domyślną wartością jest 0. - pharmacyRecipientData | PharmacyRecipientDataStruct | niewymagany
Struktura zawierająca dane adresowe kupującego leki (dot. kategorii: Zdrowie i Uroda > Leki bez recepty; wypełnienie struktury przy zakupie w kategorii innej niż wskazana, spowoduje że dane w niej przekazane będą ignorowane).- recipientFirstName | string | niewymagany
Imię kupującego leki. - recipientLastName | string | niewymagany
Nazwisko kupującego leki. - recipientAddress | string | niewymagany
Adres kupującego leki. - recipientPostcode | string | niewymagany
Kod pocztowy kupującego leki. - recipientCity | string | niewymagany
Miasto, w którym mieszka kupujący leki.
- recipientFirstName | string | niewymagany
- variantId | string | niewymagany (wymagany dla ofert z kategorii obsługujących oferty wielowariantowe. Ich lista jest dostępna w naszym FAQ)
Identyfikator kupowanego wariantu, uzyskany za pomocą metody doShowItemInfoExt.
Orientacyjna struktura wywołania metody
$dobiditem_request = array(
'sessionHandle' => '22eb99326c6be29aa16d07d622bcfbcbee94ad54846f2f4e03_1',
'bidItId' => 1086438628,
'bidUserPrice' => 15.00,
'bidQuantity' => 1,
'bidBuyNow' => 0,
'pharmacyRecipientData' => array()
'variantId' => '22eb99326c6be29aa16d07d622bcfbcbee94ad5',
);
- bid-price | string
Wysokość składanej oferty oraz informacja o dokonaniu zakupu lub aktualnym stanie licytacji.
Orientacyjna struktura odpowiedzi serwera
$dobiditem_response = array(
'bid-price' => '15,50 zł - Niestety zostałeś przelicytowany. Ktoś wcześniej zaoferował wyższą kwotę maksymalną Obecnie najwyższa oferta wynosi 15,50 zł'
);
- bidPrice | string
Wysokość składanej oferty oraz informacja o dokonaniu zakupu lub aktualnym stanie licytacji.
Orientacyjna struktura odpowiedzi serwera
$dobiditem_response = array(
'bidPrice' => '15,50 zł - Niestety zostałeś przelicytowany. Ktoś wcześniej zaoferował wyższą kwotę maksymalną Obecnie najwyższa oferta wynosi 15,50 zł'
);
- ERR_AUCTION_KILLED
Nie można pobrać informacji o wskazanej ofercie, ponieważ została ona usunięta przez administratora serwisu. - ERR_BLOCKED_USER_CANT_INVOKE_METHOD
Użytkownik z blokadą konta nie może korzystać z tej metody. - ERR_CANNOT_BID_ITEM
Nie można złożyć oferty we wskazanej ofercie (np. podano niepoprawną liczbę przedmiotów, oferowana kwota jest zbyt niska, oferta nie ma udostępnionej możliwości zakupu przez Kup Teraz!, w ofercie udostępniono jedynie możliwość zakupu przez Kup Teraz!, oferta zdążyła się zakończyć, dokonano próby zakupu alkoholu z konta o statusie Junior, itp.). - ERR_CANNOT_BID_VARIANT_NOT_PROVIDED
Aby dokonać zakupu w ofercie wielowariantowej konieczne jest wybranie wariantu przedmiotu. - ERR_INCORRECT_BUY_NOW_PRICE
Przy zakupie przez Kup Teraz!, w polu bid-user-price należy przekazać kwotę równą kwocie KT ustalonej przez sprzedającego, zgodną z widoczną w trwającej ofercie. - ERR_INVALID_ITEM_ID
Podano niepoprawny identyfikator oferty. - ERR_INVALID_QUANTITY
Ilość sztuk przedmiotu w danym wariancie deklarowana do zakupu jest nieprawidłowa (większa niż ilość dostępnych sztuk w danym wariancie lub mniejsza niż 1). - ERR_ITEM_FROM_OTHER_COUNTRY
Oferta wystawiona została w kraju innym niż kraj do którego zalogowany jest użytkownik. - ERR_ITEMS_PER_USER_LIMIT_EXCEEDED
Przekroczono ustalony przez sprzedającego limit liczby przedmiotów możliwych do zakupu przez pojedynczego użytkownika (dotyczy tylko ofert promowanych jako Okazje Allegro, które mają narzucony limit ofert dla jednego użytkownika). - ERR_NO_SESSION / ERR_SESSION_EXPIRED
Niepoprawny identyfikator sesji lub sesja wygasła. - ERR_NOCODE_CAN_BID
Nie można złożyć oferty we wskazanej ofercie - użytkownicy bez pełnej aktywacji konta nie mogą brać udziału w ofertach, w których sprzedający ustawił dla nich ograniczenie dostępu po pierwszym zakupie lub w których sprzedający (w ofercie typu Kup Teraz!) nie pozwala na płatność za pośrednictwem PayU. - ERR_NOCODE_CANNOT_BID_HOUR
Nie można złożyć oferty we wskazanej ofercie - użytkownicy bez pełnej aktywacji konta nie mogą licytować, jeżeli czas do zakończenia oferty jest krótszy niż 1 godzina. - ERR_NOCODE_NO_BUYNOW
Nie można złożyć oferty we wskazanej ofercie - użytkownicy bez pełnej aktywacji konta nie mogą korzystać z ofert typu Kup Teraz! w przypadku gdy dokonali już zakupu w swojej pierwszej ofercie (w ramach limitu 500 zł). Zasada ta obowiązuje jedynie w serwisach zagranicznych. - ERR_WEBAPI_KEY_INACTIVE
Klucz WebAPI na którym została wygenerowana sesja został zdezaktywowany (jego właściciel nie zaakceptował warunków Regulaminu WebAPI). - ERR_WEBAPI_NOT_AVAIL
Problemy z usługą Allegro WebAPI.
- ERR_AUCTION_KILLED
Nie można pobrać informacji o wskazanej ofercie, ponieważ została ona usunięta przez administratora serwisu. - ERR_BLOCKED_USER_CANT_INVOKE_METHOD
Użytkownik z blokadą konta nie może korzystać z tej metody. - ERR_CANNOT_BID_ITEM
Nie można złożyć oferty we wskazanej ofercie (np. podano niepoprawną liczbę przedmiotów, oferowana kwota jest zbyt niska, oferta nie ma udostępnionej możliwości zakupu przez Kup Teraz!, w ofercie udostępniono jedynie możliwość zakupu przez Kup Teraz!, oferta zdążyła się zakończyć, dokonano próby zakupu alkoholu z konta o statusie Junior, itp.). - ERR_CANNOT_BID_VARIANT_NOT_PROVIDED
Aby dokonać zakupu w ofercie wielowariantowej konieczne jest wybranie wariantu przedmiotu. - ERR_INCORRECT_BUY_NOW_PRICE
Przy zakupie przez Kup Teraz!, w polu bidUserPrice należy przekazać kwotę równą kwocie KT ustalonej przez sprzedającego, zgodną z widoczną w trwającej ofercie. - ERR_INVALID_ITEM_ID
Podano niepoprawny identyfikator oferty. - ERR_INVALID_QUANTITY
Ilość sztuk przedmiotu w danym wariancie deklarowana do zakupu jest nieprawidłowa (większa niż ilość dostępnych sztuk w danym wariancie lub mniejsza niż 1). - ERR_ITEM_FROM_OTHER_COUNTRY
Oferta wystawiona została w kraju innym niż kraj do którego zalogowany jest użytkownik. - ERR_ITEMS_PER_USER_LIMIT_EXCEEDED
Przekroczono ustalony przez sprzedającego limit liczby przedmiotów możliwych do zakupu przez pojedynczego użytkownika (dotyczy tylko ofert promowanych jako Okazje Allegro, które mają narzucony limit ofert dla jednego użytkownika). - ERR_NO_SESSION / ERR_SESSION_EXPIRED
Niepoprawny identyfikator sesji lub sesja wygasła. - ERR_NOCODE_CAN_BID
Nie można złożyć oferty we wskazanej ofercie - użytkownicy bez pełnej aktywacji konta nie mogą brać udziału w ofertach, w których sprzedający ustawił dla nich ograniczenie dostępu po pierwszym zakupie lub w których sprzedający (w ofercie typu Kup Teraz!) nie pozwala na płatność za pośrednictwem PayU. - ERR_NOCODE_CANNOT_BID_HOUR
Nie można złożyć oferty we wskazanej ofercie - użytkownicy bez pełnej aktywacji konta nie mogą licytować, jeżeli czas do zakończenia oferty jest krótszy niż 1 godzina. - ERR_NOCODE_NO_BUYNOW
Nie można złożyć oferty we wskazanej ofercie - użytkownicy bez pełnej aktywacji konta nie mogą korzystać z ofert typu Kup Teraz! w przypadku gdy dokonali już zakupu w swojej pierwszej ofercie (w ramach limitu 500 zł). Zasada ta obowiązuje jedynie w serwisach zagranicznych. - ERR_WEBAPI_KEY_INACTIVE
Klucz WebAPI na którym została wygenerowana sesja został zdezaktywowany (jego właściciel nie zaakceptował warunków Regulaminu WebAPI). - ERR_WEBAPI_NOT_AVAIL
Problemy z usługą Allegro WebAPI.