API middleware iArt to Joomla
Witamy na stronie poświęconej komunikacji programu iArt z API innych programów.
Spis treści:
- Konfiguracja Export APIs w programie iArt
- Struktura wysyłanego obiektu w formacie JSON
- Konfiguracja middleware
- Metody middleware
Konfiguracja Export APIs w programie iArt
Aby dodać nowe API, z którym będzie się komunikował program iArt, należy przejść do sekcji „Administracja → Export APIs”
Następnie należy kliknąć w zielony przycisk „Dodaj API”
W oknie nowego API należy wypełnić następujące pola:
- Nazwa - nazwa identyfikująca API (np. Api strony internetowej Muzeum).
- Host - adres hosta, pod którym znajduje się API.
- Nazwa użytkownika, używana do logowania się do API
- Hasło użytkownika, używane do logowania się do API
- Nazwa funkcji używanej do logowania się do API (będzie doklejana do hosta, np. https://stronamuzeum.pl/api/login
- Typ poświadczenia (grant type) - najczęściej musi być ustawiony na client_credentials.
- Nazwa zmiennej, która przekazuje id użytkownika w funkcji logującej do API (najczęściej client_id).
- Nazwa zmiennej, która przekazuje hasło użytkownika w funkcji logującej do API (najczęściej client_secret).
- Nazwa funkcji API odbierającej obiekt od programu iArt (UWAGA! W tym polu podajemy metodę:nazwę_funkcji, np. POST:api/add_object.
- Spodziewny kod odpowiedzi funkcji API odbierającej obiekt od programu iArt.
- Nazwa funkcji API odbierającej zdjęcie od programu iArt (UWAGA! W tym polu podajemy metodę:nazwę_funkcji, np. POST:api/add_photo.
- Spodziewny kod odpowiedzi funkcji API odbierającej zdjęcie od programu iArt.
- Nazwa funkcji API usuwającej obiekt (UWAGA! W tym polu podajemy metodę:nazwę_funkcji, np. DELETE:api/remove_object.
- Spodziewny kod odpowiedzi funkcji API usuwającej obiekt z API.
- Nazwa funkcji API usuwającej zdjęcie (UWAGA! W tym polu podajemy metodę:nazwę_funkcji, np. DELETE:api/remove_photo.
- Spodziewny kod odpowiedzi funkcji API usuwającej zdjęcie z API.
Kody odpowiedzi HTTP można zobaczyć TUTAJ
Nie ma ograniczeń, co do ilości zdefiniowanych APIs w programie iArt.
Po poprawnym skonfigurowaniu API, możemy sprawdzić czy program iArt się z nim łączy. W tym celu należy kliknąć guzik „Sprawdź połączenie”.
W przypadku poprawnego połączenia, powinniśmy zobaczyć następujący komunikat:
Po zdefiniowaniu podstawowej konfiguracji API, powinniśmy określić, które pola obiektu powinny być eklsportowane do określonego API. W tym celu klikamy w przycisk „Pola”.
Zobaczymy panel z dwiema kolumnami:
- W lewej kolumnie znajduje się zestaw wszystkich pól obiektów.
- W prawej są wybrane pola.
W celu określenia, które pola mają być udostępnione dla danego API, przeciągamy wybrane pola z lewej kolumny do prawej (metodą „przeciągnij i upuść”).
Klikając w ikonkę przy wybranym polu, możemy zmienić jego nazwę. Spowoduje to, że pole wysyłane do danego API będzie miało inną nazwę niż w programie iArt.
Po wybraniu wszytkich pól, należy kliknąc przycisk „Zapisz”.
Aby opublikować obiekt w API, należy wyszukać wybrany obiekt, a następnie zaznaczyć go, jako dostępny na www. Nie spowoduje to automatycznej publikacji obiektu, ale odblokuje funkcje publikacji na karcie obiektu
Udostępnianie obiektu odbywa się w karcie obiektu - w wynikach wyszukiwania kliknij przy wybranym obiekcie przycisk „Zobacz”.
Aby udostępnić zdjęcia dla danego obiektu, należy przejść do zakładki pliki, a następnie kliknąć w gwiazdkę, znajdującą się przy wybrasnym zdjęciu.
Publikacja obiektu następuje po kliknięciu w przycisk „Opublikuj w e-katalogu”
Program zapyta w jakim API obiekt ma być opublikowny
Po poprawnej publikacji, odnośny wpis na jej temat pojawi się w zakładce „Publikacje w e-katalogu”
Poprawna publikacja oznacza, że metoda API zwróciła poprawny kod HTTP zdefiniowany dla poszczególnego API.
Program iArt wysyła do API obiekt w formacie JSON, wg następującego schematu:
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 178 179 180 181 182 183 184 185 186 187 188 189 190 191 192 193 194 195 196 197 198 199 200 201 202 203 204 205 206 207 208 209 210 211 212 213 214 215 216 217 218 219 220 221 222 223 224 225 226 227 228 229 230 231 232 233 234 235 236 237 238 239 240 241 242 243 244 245 246 247 248 249 250 251 252 253 254 255 256 257 258 259 260 261 262 263 264 265 266 267 268 269 270 271 272 273 274 275 276 277 278 279 280 281 282 283 284 285 286 287 288 289 290 291 292 293 294 295 | { "id":69087, "createTime":"2020-09-10 00:09", "updateTime":"2020-09-11 15:38", "active":true, "fields":{ "0":{ "type":"group", "name":"Napis \/ znak", "id":false, "fields":{ }, "group_id":5 }, "1":{ "type":"group", "name":"Wymiary", "id":false, "fields":{ "0":{ "0":{ "type":"field", "id":56, "value":"2020-09-10", "name":"Wymiar - data pomiaru" }, "1":{ "type":"field", "id":58, "value":"100 mm", "name":"Wymiar - wysoko\u015b\u0107" }, "2":{ "type":"field", "id":59, "value":"120 mm", "name":"Wymiar - szeroko\u015b\u0107" }, "3":{ "type":"field", "id":60, "value":"130 mm", "name":"Wymiar - g\u0142\u0119boko\u015b\u0107" }, "4":{ "type":"field", "id":61, "value":"140 mm", "name":"Wymiar - \u015brednica" }, "5":{ "type":"field", "id":62, "value":"5000 g", "name":"Wymiar - masa \/ waga" }, "6":{ "type":"field", "id":65, "value":"120", "name":"Wymiar - rozmiar" }, "7":{ "type":"field", "id":63, "value":"130 mm", "name":"Wymiar - obw\u00f3d" }, "8":{ "type":"field", "id":64, "value":"140 mm", "name":"Wymiar - promie\u0144" }, "9":{ "type":"field", "id":66, "value":"150 mm", "name":"Wymiar - rozstaw" }, "10":{ "type":"field", "id":67, "value":"160 mm", "name":"Wymiar - o\u015b" }, "11":{ "type":"field", "id":55, "value":"broda", "name":"Wymiar - mierzona cz\u0119\u015b\u0107" } } }, "group_id":6 }, "2":{ "type":"field", "id":366, "value":"", "name":"Bran\u017ca" }, "3":{ "type":"field", "id":26, "value":"Maska taneczna", "name":"Tytu\u0142" }, "4":{ "type":"field", "id":299, "value":"", "name":"Analogie" }, "5":{ "type":"field", "id":507, "value":"Kultury Pozaeuropejskie", "name":"Kategoria tematyczna (Galeria MNS)" }, "6":{ "type":"field", "id":30, "value":"Dancing mask", "name":"Tytu\u0142 - t\u0142umaczenie" }, "7":{ "type":"field", "id":29, "value":"angielski", "name":"Tytu\u0142 obiektu - j\u0119zyk" }, "8":{ "type":"field", "id":21, "value":"Maska taneczna", "name":"Nazwa obiektu" }, "9":{ "type":"field", "id":73, "value":"J. B. Homann, T.C. Lotter", "name":"Wytworzenie obiektu - osoba \/ autor" }, "10":{ "type":"field", "id":74, "value":"", "name":"Wytworzenie obiektu - organizacja \/ wytw\u00f3rnia" }, "11":{ "type":"field", "id":75, "value":"", "name":"Wytworzenie obiektu - spo\u0142eczno\u015b\u0107" }, "12":{ "type":"field", "id":80, "value":"Nigeria (Afryka), ", "name":"Wytworzenie obiektu - miejsce" }, "13":{ "type":"field", "id":89, "value":"rzadka forma dekoracji", "name":"Data - dookre\u015blenie" }, "14":{ "type":"field", "id":506, "value":"1961", "name":"Data - od" }, "15":{ "type":"field", "id":505, "value":"1961", "name":"Data - do" }, "16":{ "type":"field", "id":88, "value":"XX wiek > 2. po\u0142owa XX wieku", "name":"Datowanie opisowe" }, "17":{ "type":"field", "id":71, "value":"rze\u017aba", "name":"Technika" }, "18":{ "type":"field", "id":69, "value":"rafia, drewno", "name":"Tworzywo" }, "19":{ "type":"field", "id":25, "value":"Maska taneczna historyczna", "name":"Nazwy historyczne" }, "20":{ "type":"field", "id":285, "value":"", "name":"Cykl \/ komplet" }, "21":{ "type":"field", "id":18, "value":"", "name":"Kolekcja" }, "22":{ "type":"field", "id":171, "value":"dar", "name":"Nabycie - spos\u00f3b" }, "23":{ "type":"field", "id":168, "value":"1962-06-04", "name":"Nabycie - data" }, "24":{ "type":"field", "id":161, "value":"Dzia\u0142 Kultur Pozaeuropejskich", "name":"Odpowiedzialny dzia\u0142 \/ sekcja" }, "25":{ "type":"field", "id":15, "value":"Muzeum Historii \u017byd\u00f3w Polskich POLIN", "name":"W\u0142a\u015bciciel" }, "26":{ "type":"field", "id":32, "value":"Rze\u017abiona w drewnie i czerniona maska twarzowa. Rysy twarzy regularne, z tendencj\u0105 do naturalizmu. Czo\u0142o wysokie, oczy w formie \u0142ukowatych otwor\u00f3w z zaznaczonymi powiekami, nos regularny, usta zamkni\u0119te, grube, powy\u017cej czo\u0142a \u0142ukowata, wysoka kryza. Rysy twarzy przprzypominaj\u0105 bardzo maski tajnego stowarzyszenia m\u0119\u017cczyzn \"Gelede\" pl. Joruba z p\u0142d. Nigerii, jednak maski gelede s\u0105 maskami he\u0142mowymi. Z tylnej strony maski przymocowana jest za pomoc\u0105 pasa tkaniny g\u0119sta i d\u0142uga na ok. 60 cm warstwa rafii, zakrywaj\u0105ca tancerza podczas obrz\u0119du. Wed\u0142ug danych w inwentarzu maska pochodzi z pl. Ibibio, co wydaje si\u0119 raczej w\u0105tpliwe, jest raczej uproszczon\u0105, pami\u0105tkarsk\u0105 wersj\u0105 he\u0142mowej maski stowarzyszenia Gelede.", "name":"Opis fizyczny" }, "27":{ "type":"field", "id":31, "value":"", "name":"Opis skr\u00f3cony" }, "28":{ "type":"field", "id":214, "value":"Lorem ipsum dolor sit amet, consectetur adipiscing elit. Aenean id neque eleifend, hendrerit justo a, tristique massa. Maecenas vitae metus et quam dictum tincidunt eget vel risus. Etiam sit amet turpis convallis, venenatis arcu vitae, pellentesque lectus. Aliquam erat volutpat. Sed mollis mi eget suscipit aliquet. Ut egestas commodo nisl, vitae gravida massa varius et. Duis vel ultricies velit. Suspendisse eget feugiat sapien. Mauris ac massa ut dolor porttitor bibendum. Phasellus vehicula elementum diam in rhoncus. Mauris pretium nisi scelerisque ex ullamcorper, id dignissim eros porta. Ut blandit, velit at dapibus malesuada, felis sapien finibus turpis, posuere pharetra nibh dui id nunc. Aenean viverra justo vel iaculis porttitor.Morbi sit amet mattis magna. Donec ut eros turpis. Pellentesque lobortis cursus velit vel fringilla. Donec at metus id tortor auctor porta sit amet eu arcu. Praesent imperdiet sollicitudin dui id auctor. Nunc fermentum elit mi, nec tincidunt nulla lobortis et. Duis dictum molestie sem rhoncus pulvinar. Mauris tincidunt venenatis arcu, et ultricies velit blandit nec.", "name":"Nota popularyzatorska" }, "29":{ "type":"field", "id":19, "value":"przyk\u0142ad sztuki kowalskiej", "name":"Rodzaj obiektu" } }, "files":{ "0":{ "id":1, "files_order":1, "fields":{ "0":{ "field_id":1, "order":1, "name":"Tytu\u0142", "value":"Fruzia" } }, "multimedia_id":1, "file_to_send":"\/var\/www\/iart_mns\/uploads\/jpgs\/zwykle\/0001\/IMG_20200823_140640.jpg" } }, "object_type_id":4, "inventory_number":"MNS\/AF\/99996", "inventory_book":"Inwentarz zbior\u00f3w etnograficznych Dzia\u0142u Kultur Pozaeuropejskich\u00a0", "localizations":{ "0":{ "localization":"Magazyn Zbior\u00f3w > Szafa 1 > P\u00f3\u0142ka nr 2", "type":"wewn\u0119trzna > ekspozycja", "description":"", "date_from":"2020-09-11 08:16", "date_to":null } } } |
Wartości przekazywane w obiekcie JSON:
- id - ID obiektu w programie iArt.
- createTime - data stworzenia obiektu w programie iArt.
- updateTime - data ostatniej modyfikacji obiektu w programie iArt.
- active - informacja, czy obiekt jest aktywny (1 - tak, 0 - nie).
- object_type_id - ID formatki obiektu.
- inventory_number - numer inwentarzowy obiektu.
- inventory_book - Nazwa księgi ewidencyjnej, do której przypisany jest obiekt.
- fields - dane tekstowe obiektu, zwracane są 2 typy pól:
-
Pole (type:'field') - posiadające następujące właściwości:
- type: zawsze "field"
- id: id pola w programie iArt
- name: nazwa pola w programie iArt
- value: wartośc pola
-
Grupa pól (type:'group'), charakteryzująca się tym, że zawiera powtarzalne zestawy pól z wartościami.
Grupa posiada następujące właściwości:
- group_id: id grupy w programie iArt
- type: zawsze "group",
- name: nazwa grupy w programie iArt
- fields - poszczególne, powtarzalne grupy pól, przekazywane w formie tablicy z poszczególnymi zestawami pól.
Wewnątrz każdego zestawu znajdują się poszczególne pola, z notacją wg konwencji dla Pól (type: "field").
-
Pole (type:'field') - posiadające następujące właściwości:
-
files - tablica zawierająca informacje o plikach, udostępnianych przez program iArt wg następującej konwencji:
- id: ID pliku w programie iArt,
- files_order: kolejność wysyłanego pliku,
- fields: pola identyfikujące plik wg schematu dla pól opisujących obiekt,
- multimedia_id: ID multimedium (pliku graficznego) opisywanego przez plik,
- file: nazwa pliku graficznego -
localizations - tablica zawierająca informacje o plikach, udostępnianych przez program iArt wg następującej konwencji:
- localization: nazwa lokalizacji
- type: typ lokalizacji
- description: opis lokalizacji
- date_from: data, od której obiekt znajduje (znajdował) się w danej lokalizacji
- date_to: data, do której obielkt znajdował się w danej lokalizacji.
Konfiguracja
Plik konfiguracyjny znajduje się w folderze app/Config/Api.php
Przykładowa konfiguracja:
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 178 179 180 181 182 183 184 185 186 187 188 189 190 191 192 193 194 195 196 197 198 199 200 201 202 203 204 205 206 207 208 209 210 211 212 213 214 215 216 217 218 219 220 221 222 223 224 225 226 227 228 229 230 231 232 233 234 235 236 237 238 239 240 241 242 243 244 245 246 247 248 249 250 251 252 253 254 255 256 257 258 259 260 261 262 263 264 265 266 267 268 269 270 271 272 273 274 275 276 277 278 279 280 281 282 283 284 285 286 287 288 289 290 291 292 293 294 295 296 297 298 299 300 301 302 303 304 305 306 307 308 309 310 311 312 313 314 315 316 317 318 319 320 321 322 323 324 325 326 327 328 329 330 331 332 333 334 335 336 337 338 339 340 341 342 343 344 345 346 347 348 349 350 351 352 353 354 355 356 357 358 359 360 361 362 363 364 365 366 367 368 369 370 371 372 373 374 375 376 377 378 379 380 381 382 383 384 385 386 387 388 389 390 391 392 393 394 395 396 397 398 399 400 401 402 403 404 405 | <?php namespace Config; use CodeIgniter\Config\BaseConfig; class ApiConfig extends BaseConfig { public $apiParameters = [ 'images_path' => '/var/www/mnsjoomla/images/joomgallery/details/', 'thumbnails_path' => '/var/www/mnsjoomla/images/joomgallery/thumbnails/', 'originals_path' => '/var/www/mnsjoomla/images/joomgallery/originals/', 'images_additional_path' => 'catpath', 'images_sizes' => [ 'thumbnails' => 450, 'originals' => 890 ], 'main_joomla_table' => 'e47kx_joomgallery', 'main_joomla_table_unique_field' => 'imgtitle', 'details_joomla_table' => 'e47kx_joomgallery_image_details', 'images_names_joomla_fields' => ['imgfilename','imgthumbname'], 'main_joomla_table_additional_fields' => ['access'=>1,'published'=>1,'approved'=>1,'ordering'=>1,'imgdate'=>'now'], ]; public $fieldsMappingMain = [ [ 'joomla_name' => 'imgtitle', 'iart_name' => 'inventory_number', 'joomla_table' => 'e47kx_joomgallery', 'fields' => false, 'join' => false, 'transform' => false, ], [ 'joomla_name' => 'catid', 'iart_name' => 'Kategoria tematyczna (Galeria MNS)', 'joomla_table' => 'e47kx_joomgallery', 'fields' => true, 'join' => true, 'join_table' => 'e47kx_joomgallery_catg', 'join_fields' => ['catid','cid'], 'where_field' => 'name', 'transform' => false, ], [ 'joomla_name' => 'alias', 'iart_name' => 'inventory_number', 'joomla_table' => 'e47kx_joomgallery', 'fields' => false, 'join' => false, 'transform' => true, 'transform_rules'=> [['function'=> 'str_replace','arguments'=>[['/'],['-'],'value']],['function'=>'strtolower','arguments'=>['value']]] ], [ 'joomla_name' => 'imgauthor', 'iart_name' => 'Wytworzenie obiektu - osoba / autor', 'joomla_table' => 'e47kx_joomgallery', 'fields' => true, 'join' => false, 'transform' => false, ], [ 'joomla_name' => 'imgtext', 'iart_name' => 'Nota popularyzatorska', 'joomla_table' => 'e47kx_joomgallery', 'fields' => true, 'join' => false, 'transform' => false, ], ]; public $fieldsMappingDetails = [ [ 'joomla_name' => 'additional.wlasciciel', 'iart_name' => 'Właściciel', 'joomla_table' => 'e47kx_joomgallery_image_details', 'ordering' => '1', 'separator' => '', ], [ 'joomla_name' => 'additional.kolekcja', 'iart_name' => 'Kolekcja', 'joomla_table' => 'e47kx_joomgallery_image_details', 'ordering' => '2', 'separator' => '', ], [ 'joomla_name' => 'additional.rodzaj-obiektu', 'iart_name' => 'Rodzaj obiektu', 'joomla_table' => 'e47kx_joomgallery_image_details', 'ordering' => '3', 'separator' => '', ], [ 'joomla_name' => 'additional.nazwa-obiektu', 'iart_name' => 'Nazwa obiektu', 'joomla_table' => 'e47kx_joomgallery_image_details', 'ordering' => '4', 'separator' => '', ], [ 'joomla_name' => 'additional.nazwy-hist', 'iart_name' => 'Nazwy historyczne', 'ordering' => '5', 'separator' => '', ], [ 'joomla_name' => 'additional.tytul', 'iart_name' => 'Tytuł', 'ordering' => '6', 'separator' => '', ], [ 'joomla_name' => 'additional.tytul-tlumaczenie', 'iart_name' => 'Tytuł - tłumaczenie', 'ordering' => '7', 'separator' => '', ], [ 'joomla_name' => 'additional.tytul-jezyk', 'iart_name' => 'Tytuł obiektu - język', 'ordering' => '8', 'separator' => '', ], [ 'joomla_name' => 'additional.skrocony-opis', 'iart_name' => 'Skrócony opis', 'ordering' => '9', 'separator' => '', ], [ 'joomla_name' => 'additional.slowa-klucz', 'iart_name' => 'Słowa kluczowe', 'ordering' => '10', 'separator' => '', ], [ 'joomla_name' => 'additional.napis-znak-typ', 'iart_name' => 'Napis/Znak - typ', 'ordering' => '11', 'separator' => '', ], [ 'joomla_name' => 'additional.napis-znak-tresc', 'iart_name' => 'Napis/Znak - treść', 'ordering' => '12', 'separator' => '', ], [ 'joomla_name' => 'additional.napis-znak-wyk', 'iart_name' => 'Napis/Znak - wykonawca', 'ordering' => '13', 'separator' => '', ], [ 'joomla_name' => 'additional.napis-znak-opis', 'iart_name' => 'Napis/Znak - opis', 'ordering' => '14', 'separator' => '', ], [ 'joomla_name' => 'additional.wym-m-cz', 'iart_name' => 'Wymiar - mierzona część', 'ordering' => '15', 'separator' => '', ], [ 'joomla_name' => 'additional.wym-wys', 'iart_name' => 'Wymiar - wysokość', 'ordering' => '16', 'separator' => '', ], [ 'joomla_name' => 'additional.wym-szer', 'iart_name' => 'Wymiar - szerokość', 'ordering' => '17', 'separator' => '', ], [ 'joomla_name' => 'additional.wym-gleb', 'iart_name' => 'Wymiar - głębokość', 'ordering' => '18', 'separator' => '', ], [ 'joomla_name' => 'additional.wym-sred', 'iart_name' => 'Wymiar - średnica', 'ordering' => '19', 'separator' => '', ], [ 'joomla_name' => 'additional.wym-masa-waga', 'iart_name' => 'Wymiar - masa / waga', 'ordering' => '20', 'separator' => '', ], [ 'joomla_name' => 'additional.wym-obwod', 'iart_name' => 'Wymiar - obwód', 'ordering' => '21', 'separator' => '', ], [ 'joomla_name' => 'additional.wym-promien', 'iart_name' => 'Wymiar - promień', 'ordering' => '22', 'separator' => '', ], [ 'joomla_name' => 'additional.wym-rozmiar', 'iart_name' => 'Wymiar - rozmiar', 'ordering' => '23', 'separator' => '', ], [ 'joomla_name' => 'additional.wym-rozstaw', 'iart_name' => 'Wymiar - rozstaw', 'ordering' => '24', 'separator' => '', ], [ 'joomla_name' => 'additional.wym-os', 'iart_name' => 'Wymiar - oś', 'ordering' => '25', 'separator' => '', ], [ 'joomla_name' => 'additional.tworzywo-material', 'iart_name' => 'Tworzywo', 'ordering' => '26', 'separator' => ';', ], [ 'joomla_name' => 'additional.tech', 'iart_name' => 'Technika', 'ordering' => '27', 'separator' => ';', ], [ 'joomla_name' => 'additional.wyt-organizacja-wytwor', 'iart_name' => 'Wytworzenie obiektu - organizacja / wytwórnia', 'ordering' => '28', 'separator' => ';', ], [ 'joomla_name' => 'additional.wyt-spolecznosc', 'iart_name' => 'Wytworzenie obiektu - społeczność', 'ordering' => '29', 'separator' => ';', ], [ 'joomla_name' => 'additional.wyt-rola', 'iart_name' => 'Wytworzenie obiektu - rola', 'ordering' => '30', 'separator' => ';', ], [ 'joomla_name' => 'additional.wyt-miejsce', 'iart_name' => 'Wytworzenie obiektu - miejsce', 'ordering' => '31', 'separator' => '', ], [ 'joomla_name' => 'additional.zebrano-miejsce', 'iart_name' => 'Zebrano w terenie - miejsce', 'ordering' => '32', 'separator' => '', ], [ 'joomla_name' => 'additional.wyt-dat-opis', 'iart_name' => 'Datowanie opisowe', 'ordering' => '33', 'separator' => '', ], [ 'joomla_name' => 'additional.wyt-dat-dook', 'iart_name' => 'Data - dookreślenie', 'ordering' => '34', 'separator' => '', ], [ 'joomla_name' => 'additional.wyt-dat-od', 'iart_name' => 'Data - od', 'ordering' => '35', 'separator' => '', ], [ 'joomla_name' => 'additional.wyt-dat-do', 'iart_name' => 'Data - do', 'ordering' => '36', 'separator' => '', ], [ 'joomla_name' => 'additional.wyt-dat-dat', 'iart_name' => 'Wytworzenie obiektu - datowanie - data', 'ordering' => '37', 'separator' => '', ], [ 'joomla_name' => 'additional.odp-dzial-sekcja-osoba', 'iart_name' => 'Odpowiedzialny dział/sekcja/osoba', 'ordering' => '38', 'separator' => '', ], [ 'joomla_name' => 'additional.nabycie', 'iart_name' => 'Nabycie - sposób', 'ordering' => '39', 'separator' => '', ], [ 'joomla_name' => 'additional.lok-typ', 'iart_name' => 'Lokalizacja - typ', 'ordering' => '40', 'separator' => '', ], [ 'joomla_name' => 'additional.lok-adres', 'iart_name' => 'Lokalizacja - adres', 'ordering' => '41', 'separator' => '', ], ]; } |
Lista metod:
Logowanie.
/user/login [POST]
Zmienne:
grant_type:client_credentials
client_id:{id klienta}
client_secret:{hasło}
Metoda zwraca obiekt JSON
{
"access_token": "585f05dd4c92782f4182cc2b88d732790178cc3d",
"expires_in": 3600,
"token_type": "Bearer",
"scope": "app"
}
Dodawanie i nadpisywanie obiektu.
/api/object [POST,PUT]
Zmienne:
object: przykładowy obiekt
photo: plik graficzny (jpg, png) zakodownay w base64
Poprawnie wykonana metoda zwraca kod 200.Usuwanie obiektu (wraz ze zdjęciami).
/api/object?inventory_number={numer inwentarza obiektu, np. "MUZ 356/KG/1-9"} [DELETE]Dodawanie i nadpisywanie zdjęcia.
/api/photo [POST,PUT]Usuwanie zdjęcia.
/api/photo [DELETE]Masz pytania?
Skontaktuj się
Zadzwoń pod nr 600 800 083 lub napisz maila na adres rubachello@wynalazca.com