Allegro WebAPI

Interfejs programistyczny platformy Allegro

doGetMyWonItems

Tematyka: Moje Allegro
Ostatnia zmiana: 07.03.2013 r.
Dostępność:
Metoda odtwarza pełną funkcjonalność zakładki "Kupione" w Moim Allegro. Dodatkowo umożliwia sortowanie oraz wyszukiwanie ofert po nazwie.

  1. session-id | string | wymagany
    Identyfikator sesji użytkownika, uzyskany za pomocą metody doLogin(Enc).
  2. sort-options | SortOptionsStruct | niewymagany
    Struktura zawierająca informacje o sposobie sortowania ofert.
    1. sort-type | int | niewymagany
      Parametr pozwalający na określenie typu sortowania (1 - po czasie zakończenia oferty (wartość domyślna dla zakładki), 2 - po aktualnej cenie, 3 - po nazwie oferty, 6 - po loginie sprzedającego, 11 - po ilości sztuk kupionych).
    2. sort-order | int | niewymagany
      Parametr pozwalający na określenie kierunku sortowania (1 - rosnąco, 2 - malejąco (wartość domyślna dla zakładki)).
  3. search-value | string | niewymagany
    Wyrażenie, na podstawie którego mają być wyszukane oferty (dotyczy tylko wyszukiwania po tytule oferty). Umożliwia wyszukiwanie przy użyciu znaków *, -, () oraz "".
  4. category-id | int | niewymagany
    Parametr pozwalający na określenie kategorii z jakiej mają zostać pokazane oferty.
  5. item-ids | long[] | niewymagany
    Tablica identyfikatorów ofert (maksimum: 100).
  6. page-size | int | niewymagany
    Parametr pozwalający na określenie ilości ofert wyświetlanych jednorazowo (minimum: 1, maksimum: 1000, domyślnie: 100).
  7. page-number | int | niewymagany
    Parametr pozwalający na wskazanie porcji danych, która ma być wyświetlona (domyślnie: 0).



    Orientacyjna struktura wywołania metody

    $dogetmywonitems_request = array(
       'session-id' => '22eb99326c6be29aa16d07d622bcfbcbee94ad54846f2f4e03_1',
       'sort-options' => array(
          'sort-type' => 2,
          'sort-order' => 1),
       'search-value' => 'Plecak',
       'category-id' => 10925,
       'item-ids' => array(1070356993),
       'page-size' => 25,
       'page-number' => 0
    );


    1. won-items-counter | int
      Liczba ofert wygranych (odpowiadająca filtrom podanym na wejściu metody).
    2. won-items-list | WonItemsStruct[]
      Tablica struktur zawierająca dokładne informacje o ofertach wygranych.
      1. item-id | long
        Identyfikator oferty.
      2. item-title | string
        Tytuł oferty.
      3. item-thumbnail-url | string
        Odnośnik do miniaturki oferty.
      4. item-price | ItemPriceStruct[]
        Tablica struktur zawierająca informacje o cenie przedmiotu.
        1. price-type | int
          Rodzaj ceny (1 - Kup Teraz!, 6 - cena ostateczna w licytacji).
        2. price-value | float
          Wartość ceny przedmiotu.
      5. item-bought-quantity | int
        Ilość kupionych przedmiotów.
      6. item-left-quantity | int
        Ilość pozostałych w ofercie przedmiotów.
      7. item-quantity-type | int
        Typ dostępnych w ofercie przedmiotów (1 - sztuki, 2 - komplety, 3 - pary).
      8. item-end-time | long
        Czas zakończenia oferty (Unix time).
      9. item-end-time-left | string
        Pozostały czas do zakończenia oferty .
      10. item-seller | UserInfoStruct
        Struktura zawierająca informacje o sprzedającym.
        1. user-id | int
          Identyfikator użytkownika.
        2. user-login | string
          Nazwa użytkownika.
        3. user-rating | int
          0. Pole nieaktywne.Informacje o ocenach można pobrać przez REST API
        4. user-icons | int
          Dodatkowe informacje o użytkowniku. Maska bitowa: 1 - konto bez aktywacji, 2 - konto Junior, 4 - użytkownik niezarejestrowany, 8 - strona "O mnie", 16 - konto Firma, 32 - sklep, 64 - Super Sprzedawca (tylko dla molotok.ru).
        5. user-country | int
          Identyfikator kraju użytkownika.
      11. item-bidders-counter | int
        Licznik złożonych ofert kupna.
      12. item-category-id | int
        Identyfikator kategorii w której jest wystawiona oferta.
      13. item-views-counter | int
        Liczba wyświetleń oferty.
      14. item-note | string
        Treść notatki do oferty.
      15. item-special-info | int
        Informacja o tym, czy oferta jest oznaczona jako Standard Allegro [PL], Aukro Plus [CZ] lub Super Offer [UA/KZ] (0 - nie jest, 1 - jest).
      16. item-shop-info | int
        Informacja o tym, czy oferta jest sklepowa (0 - nie jest, 1 - jest).
      17. item-product-info | long
        Pole zdezaktualizowane (zawsze będzie zwracać 0).
      18. item-payu-info | int
        Informacja o tym, czy w ofercie jest dostępny sposób płatności PayU (0 - nie jest, 1 - jest).



    Orientacyjna struktura odpowiedzi serwera

    $dogetmywonitems_response = array(
       'won-items-counter' => 1,
       'won-items-list' => array(
         array(
          'item-id' => 1070362941,
          'item-title' => 'Plecak na wycieczkę',
          'item-thumbnail-url' => 'http://img06.allegroimg.pl/photos/1966835519',
          'item-price' => array(
            array(
             'price-type' => 1,
             'price-value' => 69.99)),
          'item-bought-quantity' => 1,
          'item-left-quantity' => 0,
          'item-quantity-type' => 1,
          'item-end-time' => 1326977820,
          'item-end-time-left' => 'Zakończona',
          'item-seller' => array(,
            'user-id' => 486381,
            'user-login' => 'm010ch',
            'user-rating' => 0,
            'user-icons' => 8,
            'user-country' => 1),
          'item-bidders-counter' => 1,
          'item-category-id' => 10563,
          'item-views-counter' => 29,
          'item-note' => 'Treść notatki',
          'item-special-info' => 0,
          'item-shop-info' => 0,
          'item-product-info' => 0,
          'item-payu-info' => 1))
    );


    • ERR_INCORRECT_CATEGORY_ID
      Nieprawidłowy identyfikator kategorii.
    • ERR_INCORRECT_PAGE_NUMBER
      Nieprawidłowa wartość w parametrze page-number (mniejsza niż 0).
    • ERR_INCORRECT_PAGE_SIZE
      Nieprawidłowa wartość w parametrze page-size (mniejsza niż 0 lub większa niż 1000).
    • ERR_INCORRECT_SEARCH_VALUE
      Wyszukiwana fraza zawiera niedozwolone znaki.
    • ERR_INCORRECT_SORT_ORDER
      Nieprawidłowa wartość w parametrze sort-order.
    • ERR_INCORRECT_SORT_TYPE
      Nieprawidłowa wartość w parametrze sort-type.
    • ERR_NO_SESSION / ERR_SESSION_EXPIRED
      Niepoprawny identyfikator sesji lub sesja wygasła.
    • ERR_TOO_MANY_ITEM_IDS
      Przekazano więcej niż 100 identyfikatorów ofert.
    • 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).

    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.