Allegro WebAPI

Interfejs programistyczny platformy Allegro

doGetBidItem2

Ostatnia zmiana: ---
Dostępność:
Metoda pozwala na pobranie publicznie dostępnych informacji na temat wszystkich użytkowników, którzy dokonali zakupu w danej ofercie. Pełen podgląd nazw oraz identyfikatorów użytkowników możliwy jest tylko dla użytkowników, którzy wystawili daną ofertę - pozostali użytkownicy otrzymają wspomniane dane w formie zanonimizowanej.

  1. session-handle | string | wymagany
    Identyfikator sesji użytkownika, uzyskany za pomocą metody doLogin(Enc).
  2. item-id | int | wymagany
    Identyfikator oferty.



Orientacyjna struktura wywołania metody

$dogetbiditem2_request = array(
   'session-handle' => '22eb99326c6be29aa16d07d622bcfbcbee94ad54846f2f4e03_1',
   'item-id' => 955101613
);

  1. biditem-list | BidListStruct2[]
    Tablica struktur zawierająca informacje o wszystkich kupujących we wskazanej ofercie.
    1. bids-array | string[]
      Tablica, w której zwracane są wszystkie publicznie dostępne informacje nt. kupującego. Kolejne jej pola zawierają:
      • identyfikator oferty,
      • identyfikator użytkownika; pełna wartość tego pola widoczna jest tylko dla sprzedającego w danej ofercie, dla pozostałych w polu tym zwracane jest 0,
      • nazwa użytkownika; pełna wartość tego pola widoczna jest tylko dla sprzedającego w danej ofercie, dla pozostałych w polu tym zwracana jest nazwa użytkownika w formie zanonimizowanej (X...Y),
      • liczba punktów użytkownika,
      • status konta użytkownika (0 - konto aktywne, 1 - konto zablokowane),
      • liczba zakupionych przedmiotów w ofercie,
      • cena pojedynczego przedmiotu,
      • data zakupu (w formacie Unix time),
      • status zakupu (-1 - oferta odwołana, 0 - oferta nie zakończona sprzedażą, 1 - oferta zakończona sprzedażą),
      • data odwołania oferty (w formacie Unix time),
      • powód odwołania oferty,
      • status odwołania oferty (0 - oferta nieodwołana, 1 - oferta odwołana przez sprzedającego, 2 - oferta odwołana przez administratora serwisu).



Orientacyjna struktura odpowiedzi serwera

$dogetbiditem2_response = array(
   'biditem-list' => array(
      'bids-array' => array(
         '955101613',
         '0',
         'K...2',
         '81',
         '0',
         '1',
         '13',
         '1268683572',
         '1',
         '',
         '',
         '0'),
      'bids-array' => array(
         '955101613',
         '0',
         'g...l',
         '0',
         '0.,
         '2',
         '13',
         '1269333021',
         '1',
         '',
         '',
         '0'))
);


  • ERR_AUCTION_KILLED
    Nie można pobrać informacji o kupujących ze wskazanej ofercie, ponieważ została ona usunięta przez administratora serwisu.
  • ERR_INVALID_ITEM_ID
    Niepoprawny identyfikator oferty.
  • ERR_NO_DATABASE
    Problemy z bazą danych Allegro.
  • ERR_NO_SESSION / ERR_SESSION_EXPIRED
    Niepoprawny identyfikator sesji lub sesja wygasła.
  • 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.

Allegro nie bierze odpowiedzialności za skutki wykorzystania zamieszczonych przykładów kodu, nie daje także gwarancji ich poprawnego działania. Widoczny kod ma charakter wyłącznie poglądowy i może zawierać błędy.