REST API

Aktualna dokumentacja nowoczesnego interfejsu rest api jest dostępna pod adresem https://developers.shoper.pl/

REST API - dokumentacja interfejsu























user.group.list

Zwraca grupy użytkowników

        array call(string $session_id, "user.group.list", array($extended = false, $groups = null))
    

Parametry wejściowe

  • extended (boolean) - czy zwrócić informacje o obiektach
  • groups (array|null) - tablica identyfikatorów obiektów do pobrania lub **null** w celu pobrania wszystkich dostępnych obiektów

Wartość zwracana

  • zwracana jest tablica ID grup, chyba, że $extended==true, wtedy: (array)

Uwagi

  • Wartości tablicy zwróconej przez tą metodę od pewnego klucza mogą przyjmować wartość array('error' ⇒ -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. W celu zapewnienia kompatybilności typów zwracanych obiektów kod błędu jest sygnalizowany przez tablicę asocjacyjną zawierającą klucz 'error'

Rzucane wyjątki SoapFault

  • W przypadku próby pobrania nieistniejącej grupy, wyrzucany jest wyjątek z komunikatem **Object 'usergroup' identified as id: '{$id}' does not exist**
  • W przypadku podania pustej listy grup (array()), wyrzucany jest wyjątek z komunikatem **Invalid data container**
  • W przypadku braku dostępu do odczytu dla modułu 'klienci', wyrzucany jest wyjątek z komunikatem **Access denied**

Uwagi

  • 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)