Metoda unit.list.create
Tworzy listę jednostek miar
array call(string $session_id, "unit.list.create", array($list))
Ta metoda wywoływana jest za pośrednictwem metody call
Parametry wejściowe
- list (array) - - lista tablic asocjacyjnych zawierających dane jednostek miar o strukturze:
- ['translations'] (array) - tablica asocjacyjna zawierająca informacje o tłumaczeniach jednostki miary
- ['pl_PL'] (array) - tablica asocjacyjna zawierająca informacje o tłumaczeniu w przykładowym języku
- ['name'] (string) - nazwa jednostki miary
- ['floating_point'] (int[0/1]) - czy jednostka miary jest jednostką zmiennoprzecinkową
Wartość zwracana
- (array) - tablica zawierająca dodatnie identyfikatory dodanych obiektów lub kody błędów:
- 0 - operacja się nie udała
- -1 - podane dane są nieprawidłowe i nie spełniają wymagań walidacji
- -2 - operacja się nie udała - zabrakło czasu na zrealizowanie operacji
Wartości tablicy zwróconej przez tą metodę od pewnego klucza mogą przyjmować wartość -2 - to oznacza, że skrypt po stronie serwera nie miał już czasu na wykonanie żądanych operacji na obiektach (poprzednie iteracje przekroczyły 80% całego dostępnego czasu na wykonanie skryptu). W celu zdobycia oczekiwanych informacji, należy ponowić zapytanie wysyłając tablicę pominiętych obiektów.
Rzucane wyjątki SoapFault
- W przypadku nie podania danych kategorii w formie tablicy, rzucany jest wyjątek Invalid data container
Istnieje możliwość wystąpienia wyjątku SoapFault w przypadku nieprawidłowego działania modułu aplikacji. (np poprzez modyfikację kodu aplikacji lub poprzez nieoczekiwany błąd po stronie serwera)
Przykład wywołania w PHP
<?php // try to login try { $client = new SoapClient("http://shop.example.com/webapi/soap/?wsdl"); $session_id = $client->login($username, $password); } catch (SoapFault $fault){ die("Unable to authenticate: {$fault->faultstring}"); } // make a call try { // ta metoda nie posiada udokumentowanego przykładu } catch (SoapFault $fault){ switch($fault->faultcode){ case 2: die("Permission denied"); case 3: die("Application locked"); default: die("Error: {$fault->faultstring}"); } } ?>