Moduł daje możliwość wystawienia nowej aukcji na podstawie aukcji, która jest już wystawiona.
Wznowienie aukcji
Request Method | POST |
Request URL | http://www.mergeto.pl/webapi/renewAuction |
- id | int | wymagane
Id aukcji na podstawie której ma być wystawiona nowa aukcja. - auctionTiming | struktura | opcjonalne
Struktura zawierająca dane służące do ustawiania daty rozpoczęcia aukcji i czasu jej trwania. - startNow | boolean | opcjonalne | domyślna wartość
Jeśli jest ustawiony na true to aukcja zostanie wystawiona teraz. - futureDate | date | opcjonalne | domyślna wartość
Data wystawienia aukcji w innym terminie. Maksymalnie 14 dni do przodu. Format danych: YYYY-MM-DD. - futureHour | int | opcjonalne | domyślna wartość
Godzina wystawienia aukcji w innym terminie. Może przyjąć wartości: 0 – 23. - futureMinute | int | opcjonalne | domyślna wartość
Minuta wystawienia aukcji w innym terminie. Może przyjąć wartości: 0,15,30,45. - duration | int | opcjonalne | domyślna wartość
Czas trwania aukcji wyrażony w dniach. Zakres 1 – 30. - cyclicRepeat | int | opcjonalny | domyślna wartość
Liczba dodatkowych wystawień aukcji. Zakres 0 – 30. - cyclicInterval | int | opcjonalny | domyślna wartość
Przerwa pomiędzy kolejnymi wystawieniami aukcji. Zakres 0 – 30. - cyclicOnlyRemainingVolume | boolean | opcjonalny | domyślna wartość
Wystawianie tylko pozostałego (niesprzedanego) towaru przy wystawianiu cyklicznym. - distinguished | boolean | opcjonalny | domyślna wartość
Promowanie aukcji: wyróżnienie. - highlighted | boolean | opcjonalny | domyślna wartość
Promowanie aukcji: podświetlenie. - bold | boolean | opcjonalny | domyślna wartość
Promowanie aukcji: pogrubienie. - addressForm | struktura | opcjonalne
Struktura pozwala na przesłanie adresu dostawy / sprzedaży przypisanego do konta sprzedawcy - selectedAddressId | int | opcjonalny
Id adresu dostawy sprzedawcy. Sprzedawca może mieć kilka adresów przypisanych do swojego konta. Na chwilę obecną id adresu można odczytać przez stronę www.
Poprawne wystawienie aukcji:
{
„responseCode”:1,
„message”:”Aukcja została wystawiona pomyślnie (na podstawie aukcji o id = xxx xxx).”
}
Public key | 12345 |
Private key | 5416d7cd6ef195a0f7622a9c56b55e84 |
Request URL | http://mergeto.pl/webapi/renewAuction?publicKey=12345&hash=aa5ab8448a8c8252662d5cb8270d183dcd399b1fba76d8f433a4e8a000f55bb7 |
Request body | { "id":187968, "auctionTiming":{ "startNow":true }, "cyclicRepeat":4, "cyclicInterval":4, "cyclicOnlyRemainingVolume":true, "distinguished":true, "highlighted":true, "bold":true, "addressForm":{ "selectedAddressId":169 } } |
- [0001] Brak parametru publicKey.
Parametr publicKey powinien być dołączony do każdego komunikatu JSON (request`u).
Prosimy zapoznać się z wymaganiami dla aplikacji - [0002] Brak parametru hash.
Parametr hash powinien być dołączony do każdego komunikatu JSON (request`u).
Prosimy zapoznać się z wymaganiami dla aplikacji - [0003] Nie znaleziono konta odpowiadającego podanym parametrom.
Należy sprawdzić czy parametry przekazane w komunikacie JSON są poprawne. - [0004] Weryfikacja hash`a nie powiodła się.
Należy zapoznać się z wymaganiami dla aplikacji i sprawdzić czy generowany hash jest poprawny. - [0009] Czas trwania aukcji (duration) moze być od 1 do 30.
- [0010] Aukcja może być wystawiona za max 14 dni.
- [0011] Błąd przy tworzeniu futureDate. Sprawdź pole futureDate[YYYY-MM-DD], futureHour(0-23), futureMinute(0,15,30,45).
- [0012] Pole futureMinute moze przyjac wartości: 0,15,30 lub 45.
- [0013] Błąd danych – futureDate jest null.
- [0014] Błąd danych – auctionTiming jest null.
- [0020] Wystąpił nieokreślony błąd.
- [0023] Błąd podczas odczytu JSON`a. Komunikat: {message}
- [0027] Aukcja o podanym ID nie została znaleziona.
- [0050] Usługa Mergeto Api jest wyłączona.
- [0100] Błąd autentykacji.
Wewnętrzny błąd aplikacji. Prosimy spróbować ponownie. Jeśli problem będzie się powtarzał prosimy o kontakt z pomocą techniczną. - [0101] Brak autoryzacji.
Konto nie jest w pełni zweryfikowane.
Komunikaty standardowej walidacji:
- Pole nie może być puste.
- Pole musi zawierać od x do y znaków.
Komunikat dotyczy pól tekstowych np. tytułu aukcji czy opisu. Określa wymaganą ilość znaków. - Wartość musi być większa równa x.
Określa minimalną wartość pola. - Wartość musi być mniejsza równa x.
Określa maksymalną wartość pola. - Data rozpoczęcia musi być w przyszłości
- Nie posiadasz adresu o podanym ID.
- Parametr nie może byc pusty dla aukcji wzorcowej z zaznaczoną opcją transportu własnego.