REST API

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

REST API - dokumentacja interfejsu























subscriber.group.list.save

Aktualizuje listę Grup

        array call(string $session_id, "subscriber.group.list.save", array($list, $force = false))
    

Parametry wejściowe

  • list (array) - tablica, w której kluczem jest identyfikator grupy, a wartością tablica asocjacyjna z danymi grupy do aktualizacji:
    • name (string) - nazwa grupy
    • autoAdd (0|1) - czy automatycznie dodawać subskrybentów do tej grupy
  • force (boolean) - czy wymusić aktualizację obiektu mimo istniejącej blokady innego administratora

Wartość zwracana

  • tablica zawierająca statusy operacji dla każdego obiektu: (array)

Uwagi

  • 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 braku dostępu do edycji dla modułu 'klienci', wyrzucany jest wyjątek z komunikatem **Access denied**
  • W przypadku nie podania danych w formie tablicy, rzucany jest wyjątek **Invalid data container**

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)