API middleware iArt to webpage

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
Metody

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:

{
    "id": 69571,
    "lang": "pl",
    "createTime": "2021-07-21 13:56",
    "updateTime": "2021-07-22 09:22",
    "active": true,
    "fields": [
        {
            "type": "field",
            "id": 15,
            "value": "Muzeum Narodowe w Szczecinie",
            "name": "Właściciel",
            "values_array": [
                {
                    "record_id": 17110,
                    "variances": [],
                    "value": [
                        "Muzeum Narodowe w Szczecinie"
                    ],
                    "roles": []
                }
            ]
        },
        {
            "type": "group",
            "name": "Napis / znak ( formatka: Obiekt muzealny)",
            "id": false,
            "fields": [
                [
                    {
                        "type": "field",
                        "id": 43,
                        "value": "napis",
                        "name": "Napis / znak - typ"
                    },
                    {
                        "type": "field",
                        "id": 45,
                        "value": "nieznany",
                        "name": "Napis / znak - wykonawca"
                    },
                    {
                        "type": "field",
                        "id": 50,
                        "value": "w prawym dolnym rogu, po stronie emulsji ",
                        "name": "Napis / znak - pozycja"
                    },
                    {
                        "type": "field",
                        "id": 54,
                        "value": "dawna sygnatura wykonana atramentem",
                        "name": "Napis / znak - opis"
                    },
                    {
                        "type": "field",
                        "id": 510,
                        "value": "<p>9672</p>",
                        "name": "Napis / znak - treść"
                    }
                ],
                [
                    {
                        "type": "field",
                        "id": 43,
                        "value": "napis",
                        "name": "Napis / znak - typ"
                    },
                    {
                        "type": "field",
                        "id": 45,
                        "value": "nieznany",
                        "name": "Napis / znak - wykonawca"
                    },
                    {
                        "type": "field",
                        "id": 50,
                        "value": "po stronie emulsji",
                        "name": "Napis / znak - pozycja"
                    },
                    {
                        "type": "field",
                        "id": 54,
                        "value": " wykonany odręcznie atramentem",
                        "name": "Napis / znak - opis"
                    },
                    {
                        "type": "field",
                        "id": 510,
                        "value": "<p>Stettin.Heumarkt mit altem Rathaus um 1900</p>",
                        "name": "Napis / znak - treść"
                    }
                ]
            ],
            "group_id": 5
        },
        {
            "type": "group",
            "name": "Prawa ( formatka: Obiekt muzealny)",
            "id": false,
            "fields": [
                [
                    {
                        "type": "field",
                        "id": 253,
                        "value": "domena publiczna",
                        "name": "Prawa - typ"
                    },
                    {
                        "type": "field",
                        "id": 254,
                        "value": "POPC",
                        "name": "Prawa - posiadacz"
                    }
                ]
            ],
            "group_id": 16
        },
        {
            "type": "field",
            "id": 161,
            "value": "Dział Sztuki Dawnej",
            "name": "Odpowiedzialny dział / sekcja",
            "values_array": [
                {
                    "record_id": 5478,
                    "variances": [
                        "NSD"
                    ],
                    "roles": [],
                    "value": [
                        "Dział Sztuki Dawnej"
                    ]
                }
            ]
        },
        {
            "type": "field",
            "id": 507,
            "value": "Historia Szczecina > Ikonografia Szczecina XVII-XIX w.",
            "name": "Kategoria tematyczna (Galeria MNS)",
            "values_array": [
                {
                    "record_id": 11916,
                    "variances": [],
                    "roles": [],
                    "value": [
                        "Historia Szczecina",
                        "Ikonografia Szczecina XVII-XIX w."
                    ]
                }
            ]
        },
        {
            "type": "field",
            "id": 18,
            "value": "kolekcje Działu Sztuki Dawnej > negatywy i reprodukcje fotografii",
            "name": "Kolekcja",
            "values_array": [
                {
                    "record_id": 15131,
                    "variances": [],
                    "roles": [],
                    "value": [
                        "kolekcje Działu Sztuki Dawnej",
                        "negatywy i reprodukcje fotografii"
                    ]
                }
            ]
        },
        {
            "type": "field",
            "id": 285,
            "value": "",
            "name": "Cykl / komplet"
        },
        {
            "type": "field",
            "id": 21,
            "value": "negatyw 13/18",
            "name": "Nazwa obiektu"
        },
        {
            "type": "field",
            "id": 19,
            "value": "negatyw",
            "name": "Rodzaj obiektu",
            "values_array": [
                {
                    "record_id": 15581,
                    "variances": [],
                    "roles": [],
                    "value": [
                        "negatyw"
                    ]
                }
            ]
        },
        {
            "type": "field",
            "id": 26,
            "value": "Stettin. Heumarkt mit altem Rathaus um 1900",
            "name": "Tytuł"
        },
        {
            "type": "field",
            "id": 30,
            "value": "Szczecin. Rynek Sienny ze starym Ratuszem około 1900",
            "name": "Tytuł - tłumaczenie"
        },
        {
            "type": "field",
            "id": 29,
            "value": "niemiecki",
            "name": "Tytuł obiektu - język",
            "values_array": [
                {
                    "record_id": 537,
                    "variances": [],
                    "roles": [],
                    "value": [
                        "niemiecki"
                    ]
                }
            ]
        },
        {
            "type": "field",
            "id": 73,
            "value": "nieznany",
            "name": "Wytworzenie obiektu - osoba / autor",
            "values_array": [
                {
                    "record_id": 46,
                    "variances": [],
                    "value": [
                        "nieznany"
                    ],
                    "roles": []
                }
            ]
        },
        {
            "type": "field",
            "id": 74,
            "value": "",
            "name": "Wytworzenie obiektu - organizacja / wytwórnia"
        },
        {
            "type": "field",
            "id": 75,
            "value": "",
            "name": "Wytworzenie obiektu - społeczność"
        },
        {
            "type": "field",
            "id": 80,
            "value": "Szczecin (województwo zachodniopomorskie)",
            "name": "Wytworzenie obiektu - miejsce",
            "values_array": [
                {
                    "record_id": 15520,
                    "variances": [],
                    "value": [
                        "Szczecin (województwo zachodniopomorskie)"
                    ],
                    "roles": []
                }
            ]
        },
        {
            "type": "field",
            "id": 94,
            "value": "",
            "name": "Zebrano w terenie - miejsce"
        },
        {
            "type": "field",
            "id": 55,
            "value": "cały obiekt",
            "name": "Wymiar - mierzona część",
            "values_array": [
                {
                    "record_id": 11952,
                    "variances": [],
                    "roles": [],
                    "value": [
                        "cały obiekt"
                    ]
                }
            ]
        },
        {
            "type": "field",
            "id": 62,
            "value": "",
            "name": "Wymiar - masa / waga"
        },
        {
            "type": "field",
            "id": 57,
            "value": "",
            "name": "Wymiar - jednostka miary"
        },
        {
            "type": "field",
            "id": 59,
            "value": "18 cm",
            "name": "Wymiar - szerokość"
        },
        {
            "type": "field",
            "id": 61,
            "value": "",
            "name": "Wymiar - średnica"
        },
        {
            "type": "field",
            "id": 58,
            "value": "13 cm",
            "name": "Wymiar - wysokość"
        },
        {
            "type": "field",
            "id": 71,
            "value": "fotograficzne > negatyw",
            "name": "Technika",
            "values_array": [
                {
                    "record_id": 4164,
                    "variances": [],
                    "roles": [],
                    "value": [
                        "fotograficzne",
                        "negatyw"
                    ]
                }
            ]
        },
        {
            "type": "field",
            "id": 69,
            "value": "materiał przetworzony > szkło",
            "name": "Tworzywo",
            "values_array": [
                {
                    "record_id": 11039,
                    "variances": [],
                    "roles": [],
                    "value": [
                        "materiał przetworzony",
                        "szkło"
                    ]
                }
            ]
        },
        {
            "type": "field",
            "id": 92,
            "value": "Szczecin (województwo zachodniopomorskie); wozy > wozy konne; dzień targowy; targi; przekupki; stragany; Rynek Sienny (Szczecin); gmach giełdy (Szczecin, Panieńska); Ratusz Staromiejski (Szczecin); ratusze; budynki; place; ulice; dzielnice; miasta",
            "name": "Słowa kluczowe",
            "values_array": [
                {
                    "record_id": 13808,
                    "variances": [],
                    "roles": [],
                    "value": [
                        "Szczecin (województwo zachodniopomorskie)"
                    ]
                },
                {
                    "record_id": 15592,
                    "variances": [
                        "konie"
                    ],
                    "roles": [],
                    "value": [
                        "wozy",
                        "wozy konne"
                    ]
                },
                {
                    "record_id": 15591,
                    "variances": [],
                    "roles": [],
                    "value": [
                        "dzień targowy"
                    ]
                },
                {
                    "record_id": 15590,
                    "variances": [],
                    "roles": [],
                    "value": [
                        "targi"
                    ]
                },
                {
                    "record_id": 15589,
                    "variances": [],
                    "roles": [],
                    "value": [
                        "przekupki"
                    ]
                },
                {
                    "record_id": 15588,
                    "variances": [],
                    "roles": [],
                    "value": [
                        "stragany"
                    ]
                },
                {
                    "record_id": 15587,
                    "variances": [],
                    "roles": [],
                    "value": [
                        "Rynek Sienny (Szczecin)"
                    ]
                },
                {
                    "record_id": 15586,
                    "variances": [
                        "Börse",
                        "Haus der Wirtschaft (Stettin, Frauenstraße)"
                    ],
                    "roles": [],
                    "value": [
                        "gmach giełdy (Szczecin, Panieńska)"
                    ]
                },
                {
                    "record_id": 15585,
                    "variances": [
                        "Altes Rathaus",
                        "budynki",
                        "Rathaus"
                    ],
                    "roles": [],
                    "value": [
                        "Ratusz Staromiejski (Szczecin)"
                    ]
                },
                {
                    "record_id": 15584,
                    "variances": [],
                    "roles": [],
                    "value": [
                        "ratusze"
                    ]
                },
                {
                    "record_id": 15533,
                    "variances": [],
                    "roles": [],
                    "value": [
                        "budynki"
                    ]
                },
                {
                    "record_id": 15583,
                    "variances": [],
                    "roles": [],
                    "value": [
                        "place"
                    ]
                },
                {
                    "record_id": 12641,
                    "variances": [],
                    "roles": [],
                    "value": [
                        "ulice"
                    ]
                },
                {
                    "record_id": 15582,
                    "variances": [],
                    "roles": [],
                    "value": [
                        "dzielnice"
                    ]
                },
                {
                    "record_id": 12022,
                    "variances": [],
                    "roles": [],
                    "value": [
                        "miasta"
                    ]
                }
            ]
        },
        {
            "type": "field",
            "id": 32,
            "value": "",
            "name": "Opis fizyczny"
        },
        {
            "type": "field",
            "id": 31,
            "value": "",
            "name": "Opis skrócony"
        },
        {
            "type": "field",
            "id": 214,
            "value": "",
            "name": "Nota popularyzatorska"
        },
        {
            "type": "field",
            "id": 171,
            "value": "pozyskanie własne",
            "name": "Nabycie - sposób",
            "values_array": [
                {
                    "record_id": 1691,
                    "variances": [],
                    "roles": [],
                    "value": [
                        "pozyskanie własne"
                    ]
                }
            ]
        },
        {
            "type": "field",
            "id": 88,
            "value": "XIX wiek > 2. połowa XIX wieku > 4. ćwierć XIX wieku > koniec XIX wieku",
            "name": "Datowanie opisowe",
            "values_array": [
                {
                    "record_id": 4756,
                    "variances": [],
                    "roles": [],
                    "value": [
                        "XIX wiek",
                        "2. połowa XIX wieku",
                        "4. ćwierć XIX wieku",
                        "koniec XIX wieku"
                    ]
                }
            ]
        },
        {
            "type": "field",
            "id": 89,
            "value": "około",
            "name": "Data - dookreślenie",
            "values_array": [
                {
                    "record_id": 2696,
                    "variances": [],
                    "roles": [],
                    "value": [
                        "około"
                    ]
                }
            ]
        },
        {
            "type": "field",
            "id": 85,
            "value": "",
            "name": "Data"
        },
        {
            "type": "field",
            "id": 506,
            "value": "1898",
            "name": "Data - od"
        },
        {
            "type": "field",
            "id": 505,
            "value": "1900",
            "name": "Data - do"
        }
    ],
    "files": [
        {
            "id": 990,
            "files_order": 1,
            "fields": [
                {
                    "field_id": 3,
                    "order": 2,
                    "name": "Tytuł",
                    "value": "mns/a.foto/5335 01 multi"
                }
            ],
            "multimedia_id": 1049,
            "file_to_send": "\\\\SPNTDATA\\dataiart\\jpgs\\zwykle\\0001\\MNS AFoto 5335.jpg"
        }
    ],
    "object_type_id": 4,
    "inventory_number": "MNS/A.FOTO/5335",
    "inventory_book": "Archiwum Fotografii Działu Sztuki Dawnej",
    "localizations": [
        {
            "localization": "",
            "type": "",
            "description": "",
            "date_from": "",
            "date_to": ""
        }
    ],
    "parent": false,
    "kids": [],
    "siblings": [],
    "relations": [
        {
            "name": "Ikonografia Szczecina XVII-XIX w.",
            "id": 17,
            "description": "Pellentesque fermentum enim massa, vel egestas orci scelerisque non. Vivamus faucibus sem sit amet risus maximus bibendum. Fusce ornare quam id lacus consectetur dignissim. ",
            "objects": [
                "MNS/A.FOTO/5335",
                "MNS/H/68",
                "MNS/H/114",
                "MNS/H/235",
                "MNS/H/236",
                "MNS/H/566",
                "MNS/H/707",
                "MNS/H/708",
                "MNS/H/773",
                "MNS/H/802",
                "MNS/H/909",
                "MNS/H/911",
                "MNS/H/916",
                "MNS/H/917",
                "MNS/H/922",
                "MNS/H/923",
                "MNS/H/925",
                "MNS/H/927",
                "MNS/H/932",
                "MNS/H/944",
                "MNS/H/946",
                "MNS/H/999",
                "MNS/H/1000",
                "MNS/H/1012",
                "MNS/H/1013",
                "MNS/H/1019",
                "MNS/H/1066",
                "MNS/H/1067",
                "MNS/H/1078"
            ]
        }
    ]
}

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").
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:

<?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]

Zmienne:
object: przykładowy obiekt
Pliki graficzne są wysyłane jako pliki dołączone do formularza

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]

Masz pytania?

Skontaktuj się

Zadzwoń pod nr 600 800 083 lub napisz maila na adres rubachello@wynalazca.com

API middleware iArt to webpage

Konfiguracja Export APIs w programie iArt

Konfiguracja

Lista metod:

Masz pytania?

Skontaktuj się

Andreas Rubachello proudly presents:

API middleware iArt to webpage

click to show manual (boring)