Metoda checkObjectListModificationTime
Pobiera znacznik czasu ostatniej modyfikacji listy obiektów tego samego typu.
array checkObjectListModificationTime(string session_id, integer object_type, array object_id_list)
Parametry wejściowe
- session_id (string) - identyfikator sesji użytkownika
- object_type (int) - typ obiektu do sprawdzenia (zobacz listę typów obiektów)
- object_id_list (array) - tablica identyfikatorów obiektów do sprawdzenia
W przypadku sprawdzania czasu modyfikacji obiektu typu CONFIG (object_type ⇒ 0) należy podać object_id = 0
Wartość zwracana
- timestamp_list (array) - tablica (wektor) znaczników czasu ostatniej modyfikacji kolejnych podanych obiektów, o długości tablicy podanej jako trzeci parametr metody. Pojedyńcza wartość może być równa 0 - obiekt nie istnieje.
Wartości tablicy 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 nieprawidłowego identyfikatora sesji lub nagłego usunięcia użytkownika, rzucany jest wyjątek z komunikatem Permission denied i kodem błędu 2
- W przypadku blokady aplikacji przez innego użutkownika, rzucany jest wyjątek z komunikatem Application locked i kodem błędu 3
- W przypadku podania nieprawidłowego typu obiektu (zobacz listę typów obiektów), rzucany jest wyjątek z komunikatem Object type is not valid
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 /** * Logowanie do API * * @param resource $c cURL resource handle * @param string $login Login użytkownika * @param string $password Hasło użytkownika * @return string Indentyfikatorr sesji użytkownika */ function login($c, $login, $password) { $params = Array( "method" => "login", "params" => Array($login, $password) ); curl_setopt($c, CURLOPT_POSTFIELDS, "json=" . json_encode($params)); $result = (Array)json_decode(curl_exec($c)); if (isset($result['error'])) { return null; } else { return $result[0]; } } $c = curl_init(); curl_setopt($c, CURLOPT_URL, 'http://shop.example.com/webapi/json/'); curl_setopt($c, CURLOPT_POST, true); curl_setopt($c, CURLOPT_RETURNTRANSFER, 1); // zalogowanie użytkownika i pobranie identyfikatora sesji $session = login($c, "api", "test"); if ($session != null) { $params = Array( "method" => "checkObjectListModificationTime", "params" => Array($session, 26, Array(5, 6, 7)) // id_sesji, typ obiektu (produkt), tablica id produktów ); // zakodowanie parametrów dla metody POST $postParams = "json=" . json_encode($params); curl_setopt($c, CURLOPT_POSTFIELDS, $postParams); // dekodowanie rezultatu w formacie JSON do tablicy result $data = curl_exec($c); $result = (Array) json_decode($data); // sprawdzenie, czy wystąpił błąd if (isset($result['error'])) { echo "Wystąpił błąd: " . $result['error'] . ", kod: " . $result['code']; } else { foreach ($result as $item) { echo "Data modyfikacji obiektu: " . date("d-m-Y h:i:s", $item) . "<br>"; } } } else { echo "Wystąpił błąd logowania"; } curl_close($c); ?>