Wymiana danych i usług

Połącz bibliotekę z jej stroną, źródłami danych i urządzeniami.

LibraSystem udostępnia interfejsy do wymiany opisów, sprawdzania dostępności i obsługi zdarzeń. Zakres połączenia ustalamy dla konkretnej usługi, aplikacji lub urządzenia.

Interfejs dobrany do zadania

Katalog, urządzenie i operator wymagają właściwego sposobu wymiany danych.

Dostęp ograniczony zakresem

Konta usługowe i klucze przypisują uprawnienia konkretnej integracji.

Sprawdzalny wynik połączenia

Historia i próby pomagają ocenić pełny przebieg wymiany.

Korzystaj z opisów i udostępniaj metadane

Z39.50 i SRU/CQL pozwalają wyszukiwać w podłączonych katalogach oraz udostępniać publiczne opisy. MARCXML i ISO 2709 służą wymianie plików, a mapowanie i kontrola duplikatów pomagają włączyć pozyskane dane do katalogu.

OAI-PMH obsługuje pobieranie zewnętrznych zbiorów oraz publikowanie własnych metadanych. Przyłączenie do wybranego agregatora wymaga dopasowania profilu opisów i warunków współpracy. Samo udostępnienie protokołu nie oznacza automatycznej obecności w każdym serwisie.

Dane katalogu na stronie i w innych aplikacjach

Publiczne API obejmuje wyszukiwanie, rekordy, dostępność, nowości i kolekcje. Dzięki temu strona biblioteki może pokazać wybrane informacje z katalogu. Webhooki przekazują zdarzenia, np. zwrot, gotową rezerwację lub potwierdzoną płatność.

Integrator korzysta z dokumentacji OpenAPI, wersjonowania i uzgodnionego zakresu dostępu. Klucze, konta usługowe, limity i dzienniki pomagają kontrolować połączenie. Kompatybilność z dotychczasowymi odwołaniami do API OPAC SOWA sprawdzamy dla używanych operacji i formatów.

  • Podpisy webhooków, ponowienia i historia dostaw.
  • Uprawnienia przypisane integracji zamiast konta pracownika.
  • Możliwość unieważnienia lub rotacji dostępu.

Tożsamość, wiadomości, płatności i samoobsługa

Zakres obejmuje login.gov.pl, zewnętrzne OIDC i logowanie organizacyjne, w tym Microsoft Entra ID oraz SAML. Poczta, SMS, płatności, OCR i antywirus są podłączane jako konfigurowane usługi. Każda wymaga właściwych dostępów oraz próby działania.

SIP2 i API urządzeń łączą stanowiska samoobsługowe i książkomaty z obiegiem. Przed uruchomieniem trzeba sprawdzić model, wersję i potrzebne komunikaty. Wdrożenie określa odpowiedzialność za system, sprzęt, sieć oraz relację z dostawcą zewnętrznym.

Przykład: nowości katalogowe na stronie biblioteki

Witryna biblioteki może pobierać listę nowości i prowadzić odwiedzającego do właściwego rekordu. Integrator uzgadnia zakres danych, częstotliwość odświeżania i zachowanie strony, gdy źródło chwilowo nie odpowiada. W ten sposób opis na stronie i katalog pozostają częścią jednej ścieżki czytelnika.

Przed realizacją potrzebne są informacje o obecnej witrynie i używanych połączeniach. Dla istniejących odwołań do API OPAC SOWA sprawdzamy konkretne operacje oraz format odpowiedzi. Zgodność ustalamy na podstawie takiej próby, bez zakładania identyczności wszystkich interfejsów.

Krok po kroku

Przygotowanie połączenia z usługą

  1. Opisz oczekiwany wynik

    Wskaż system zewnętrzny, dane oraz czynności, które mają być połączone.

  2. Uzgodnij interfejs i dostępy

    Sprawdź dokumentację, wersję, uprawnienia oraz wymagania operatora.

  3. Sprawdź scenariusze wymiany

    Przetestuj poprawny przebieg, odmowę, opóźnienie i ponowienie komunikatu.

Pytania i odpowiedzi

Warto wiedzieć

Czy integrator otrzyma dokumentację interfejsów?

Zakres obejmuje dokumentację OpenAPI i opis protokołów. Przed pracą należy ustalić potrzebne operacje, wersję interfejsu, uprawnienia i środowisko do prób.

Czy obsługa login.gov.pl oznacza aktywne połączenie każdej biblioteki?

Nie. Uruchomienie wymaga właściwego przyłączenia, konfiguracji i testów dla danego wdrożenia. Szczegóły opisuje osobna strona tej integracji.

Czy dotychczasowa strona biblioteki może pobierać nowości?

API udostępnia nowości i kolekcje. Trzeba sprawdzić sposób pobierania danych przez stronę, dopasować wywołania i uzgodnić limity oraz prezentowany zakres.

Porozmawiajmy o Twojej bibliotece

Pokaż nam potrzeby.
My pokażemy możliwości.

Przejdziemy przez scenariusze ważne dla Twojej placówki i ustalimy zakres dalszej rozmowy.

Opisz integrację, której potrzebujesz