Strict Standards: Declaration of action_plugin_searchtext::register() should be compatible with DokuWiki_Action_Plugin::register($controller) in /lib/plugins/searchtext/action.php on line 14

Warning: Cannot modify header information - headers already sent by (output started at /lib/plugins/searchtext/action.php:14) in /inc/auth.php on line 313

Warning: Cannot modify header information - headers already sent by (output started at /lib/plugins/searchtext/action.php:14) in /inc/actions.php on line 163
webapi:unit.list.create [Shop Docs]

Dokumentacja techniczna

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

  1. 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

  1. (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}");
    }
}
 
?>