--- title: Syteca API Bridge description: Syteca API Bridge --- [Przejdź do treści](https://kb.securivy.com/pl/kb/syteca-api-bridge#main-content) Polski Pokaż podmenu do tłumaczenia ![](https://kb.securivy.com/hs-fs/hubfs/Logo%20Securivy/Logo%20Securivy%20Oferta.png?width=100&height=75&name=Logo%20Securivy%20Oferta.png) Otwórz główne menu nawigacji Zamknij główne menu nawigacji - Polski Pokaż podmenu do tłumaczenia - Kontakt z nami Kontakt z nami Jak możemy Ci pomóc? - Brak sugerowanych wyników, ponieważ pole wyszukiwania jest puste. 1. [Baza Wiedzy Securivy](https://kb.securivy.com/pl/kb?hsLang=pl) 2. [Syteca On-Premises](https://kb.securivy.com/pl/kb/syteca-on-premises?hsLang=pl) 3. [SDK (dla deweloperów)](https://kb.securivy.com/pl/kb/syteca-on-premises?hsLang=pl#sdk-dla-deweloper%C3%B3w) 16 września 2025 # Syteca API Bridge ## Syteca API Bridge ### **Spis treści** 1. [Czym jest API Bridge?](https://kb.securivy.com/pl/kb/syteca-api-bridge#czym-jest-API-Bridge) 2. [Interfejs REST](https://kb.securivy.com/pl/kb/syteca-api-bridge#interfejs-rest)**** 3. [Jak korzystać z API Bridge](https://kb.securivy.com/pl/kb/syteca-api-bridge#jak-korzystac-z-api-bridge) 4. [Jak skonfigurować API Bridge w Konsoli Zarządzania](https://kb.securivy.com/pl/kb/syteca-api-bridge#jak-skonfigurowac-api-bridge-w-konsoli-zarzadzania) **1. Czym jest API Bridge?** Funkcja integracji z systemami zgłoszeniowymi w Syteca umożliwia wymuszanie podania numeru zgłoszenia przez użytkownika przy logowaniu do komputera z agentem monitorowania. Więcej informacji znajdziesz w sekcji *Integracja z systemami zgłoszeniowymi*. [![TicketingAPI](https://kb.securivy.com/hs-fs/hubfs/TicketingAPI.png?width=402&height=422&name=TicketingAPI.png)](https://kb.securivy.com/hubfs/TicketingAPI.png?hsLang=pl) Problemem, który należało rozwiązać, było następujące ograniczenie: ogólna koncepcja polegała na tworzeniu adaptera dla każdego nowego systemu zgłoszeniowego, co jest trudne w utrzymaniu ze względu na różnorodność API i konieczność wprowadzania zmian w produkcie przy każdej nowej integracji. [![many](https://kb.securivy.com/hs-fs/hubfs/many.png?width=670&height=399&name=many.png)](https://kb.securivy.com/hubfs/many.png?hsLang=pl) Wszystkie komponenty integrujące działały wewnątrz produktu, co powodowało, że każda zmiana API, czy nowy system zgłoszeniowy, wymagały wydania nowej wersji produktu. Dodatkowo niektóre systemy mają niestandardowe lub zmienne API, co utrudnia ich implementację. **Rozwiązaniem** tych problemów jest **API Bridge** — komponent zaprojektowany z myślą o elastycznej integracji. Główna idea polega na zdefiniowaniu oczekiwanego interfejsu oraz dostarczeniu prostej usługi, która ten interfejs implementuje. Udostępniamy kod źródłowy tej usługi, aby każdy mógł ją dostosować do dowolnego systemu zgłoszeniowego — czy to znanego (np. SysAid, ServiceNow), czy własnego. [![APIBridge](https://kb.securivy.com/hs-fs/hubfs/APIBridge.png?width=670&height=612&name=APIBridge.png)](https://kb.securivy.com/hubfs/APIBridge.png?hsLang=pl) Nie ma potrzeby wydawania nowej wersji Syteca — wystarczy dostosować API Bridge do nowego systemu. Nie zależy nam od konkretnego języka czy kodu — wystarczy, że interfejs REST będzie zgodny. **API Bridge** to usługa REST, którą uruchamiasz jako zewnętrzną usługę. Powinna ona implementować określony interfejs REST. Tak długo jak to wymaganie jest spełnione, możesz modyfikować API Bridge według własnych potrzeb. **2. Interfejs REST** Poniżej przedstawiono wymagany interfejs REST w formacie OpenAPI: ``` openapi: 3.0.0info: version: "0" title: "Syteca Ticketing System Integration API Bridge"paths: /connect: post: summary: Żądanie sessionID. tags: [bridge] requestBody: required: false content: application/json: schema: type: object properties: connectionString: type: string responses: '200': description: Obiekt JSON zawierający ID zgłoszenia i status. content: application/json: schema: type: object properties: sessionId: type: string '422': { description: Błędny connection string. } default: { description: Nieoczekiwany błąd. } /ticket-status: get: summary: Sprawdzenie statusu zgłoszenia. description: Weryfikuje, czy zgłoszenie istnieje i nie jest zamknięte. tags: [bridge] parameters: - name: sessionId in: query required: true schema: { type: string } - name: ticketId in: query required: true schema: { type: string } responses: '200': description: Obiekt JSON zawierający ID zgłoszenia i status. content: application/json: schema: type: object properties: ticketId: { type: string } status: { type: number } '401': { description: Nieautoryzowane (nieważna sesja). } '404': { description: Nie znaleziono zgłoszenia. } default: { description: Nieoczekiwany błąd. } /add-ticket-comment: post: summary: Dodanie komentarza do zgłoszenia. description: Dodaje komentarz z linkiem do miejsca w wynikach monitorowania w Konsoli Zarządzania. tags: [bridge] requestBody: required: true content: application/json: schema: type: object required: [sessionId, ticketId, ticketComment] properties: sessionId: { type: string } ticketId: { type: string } ticketComment: { type: string } responses: '201': { description: OK. } '401': { description: Nieautoryzowane (nieważna sesja). } '404': { description: Nie znaleziono zgłoszenia. } default: { description: Nieoczekiwany błąd. ``` Ten kod opisuje interfejs REST, który powinien być obsługiwany przez API Bridge. Np. `/connect` oznacza, że jeśli usługa działa pod adresem `http://127.0.0.1/`, to pod `http://127.0.0.1/connect` musi być możliwość wysyłania żądań POST. [![image2019-9-9\_11-38-43](https://kb.securivy.com/hs-fs/hubfs/image2019-9-9_11-38-43.png?width=603&height=405&name=image2019-9-9_11-38-43.png)](https://kb.securivy.com/hubfs/image2019-9-9_11-38-43.png?hsLang=pl) **3. Jak korzystać z API Bridge** Możesz zaimplementować usługę samodzielnie, w dowolnym języku dostosowanym do swojej infrastruktury. Dostępna jest darmowa usługa Swagger ([https://swagger.io/](https://swagger.io/)), która na podstawie specyfikacji OpenAPI generuje prostą usługę w wybranym języku. Dostarczamy przykład usługi napisanej w ASP.NET Core. Możesz: - skompilować ją ze źródeł, - lub uruchomić gotowy plik wykonywalny. **Uwaga**: Przykładowa usługa nie jest gotowym rozwiązaniem produkcyjnym — służy tylko do testów i jako baza do dalszej implementacji. Do testowania udostępniamy plik `.json` z przykładowym zestawem zgłoszeń — należy umieścić go w katalogu `wwwroot`. Plik JSON znajduje się w archiwum z kodem źródłowym. **Aby uruchomić usługę testową:** - Rozpakuj archiwum `APIBridgePackage`. - Przenieś plik `.json` do folderu `wwwroot`. [![image2019-10-8\_16-57-14](https://kb.securivy.com/hs-fs/hubfs/image2019-10-8_16-57-14.png?width=626&height=303&name=image2019-10-8_16-57-14.png)](https://kb.securivy.com/hubfs/image2019-10-8_16-57-14.png?hsLang=pl) - Edytuj plik JSON (np. w Notatniku): - W sekcji **Sessions** zdefiniuj dane logowania do systemu zgłoszeniowego. - W sekcji **Tickets** podaj nazwę zgłoszenia, które użytkownik musi wpisać przy logowaniu. **Uwaga:** Domyślne statusy zgłoszeń: - **0 – zgłoszenie nie znalezione** - **1 – zgłoszenie aktywne** - **2 – zgłoszenie zamknięte** ![image2019-10-8\_16-58-35](https://kb.securivy.com/hs-fs/hubfs/image2019-10-8_16-58-35.png?width=626&height=321&name=image2019-10-8_16-58-35.png) - W folderze `APIBridgeSampleBinaries` uruchom `IO.Swagger`. [![image2019-10-8\_16-59-18](https://kb.securivy.com/hs-fs/hubfs/image2019-10-8_16-59-18.png?width=626&height=432&name=image2019-10-8_16-59-18.png)](https://kb.securivy.com/hubfs/image2019-10-8_16-59-18.png?hsLang=pl) - W oknie konsoli podaj numer portu, który będzie używany do komunikacji z Syteca i systemem zgłoszeniowym, a następnie naciśnij Enter. **Uwaga**: Ten port należy wskazać podczas konfiguracji integracji w Konsoli Zarządzania. [![image2019-10-8\_16-59-57](https://kb.securivy.com/hs-fs/hubfs/image2019-10-8_16-59-57.png?width=624&height=247&name=image2019-10-8_16-59-57.png)](https://kb.securivy.com/hubfs/image2019-10-8_16-59-57.png?hsLang=pl) - Adres URL usługi zgłoszeniowej zostanie wyświetlony w konsoli. [![image2019-10-8\_17-0-32](https://kb.securivy.com/hs-fs/hubfs/image2019-10-8_17-0-32.png?width=624&height=373&name=image2019-10-8_17-0-32.png)](https://kb.securivy.com/hubfs/image2019-10-8_17-0-32.png?hsLang=pl) **4. Jak skonfigurować API Bridge w Konsoli Zarządzania** Aby dowiedzieć się, jak skonfigurować dane uwierzytelniające w Konsoli Zarządzania, zapoznaj się z sekcją **Definiowanie ustawień integracji z systemem zgłoszeniowym**. - [Ogólne](https://kb.securivy.com/pl/kb/og%C3%B3lne?hsLang=pl) - [Syteca On-Premises](https://kb.securivy.com/pl/kb/syteca-on-premises?hsLang=pl#main-content) - [Wdrożenie i instalacja Syteca On-Premises](https://kb.securivy.com/pl/kb/syteca-on-premises?hsLang=pl#wdro%C5%BCenie-i-instalacja-syteca-on-premises) - [Instrukcja obsługi](https://kb.securivy.com/pl/kb/syteca-on-premises?hsLang=pl#instrukcja-obs%C5%82ugi) - [Agent Monitorowania dla Systemu Windows](https://kb.securivy.com/pl/kb/syteca-on-premises?hsLang=pl#agent-monitorowania-dla-systemu-windows) - [Agent monitorowania macOS](https://kb.securivy.com/pl/kb/syteca-on-premises?hsLang=pl#agent-monitorowania-macos) - [Agent monitorowania Linux](https://kb.securivy.com/pl/kb/syteca-on-premises?hsLang=pl#agent-monitorowania-linux) - [PAM](https://kb.securivy.com/pl/kb/syteca-on-premises?hsLang=pl#pam) - [UEBA](https://kb.securivy.com/pl/kb/syteca-on-premises?hsLang=pl#ueba) - [Żądania dostępu](https://kb.securivy.com/pl/kb/syteca-on-premises?hsLang=pl#%C5%BC%C4%85dania-dost%C4%99pu) - [Blokowanie użytkowników](https://kb.securivy.com/pl/kb/syteca-on-premises?hsLang=pl#blokowanie-u%C5%BCytkownik%C3%B3w) - [Grupy agentów monitorowania](https://kb.securivy.com/pl/kb/syteca-on-premises?hsLang=pl#grupy-agent%C3%B3w-monitorowania) - [Alerty](https://kb.securivy.com/pl/kb/syteca-on-premises?hsLang=pl#alerty) - [Raporty](https://kb.securivy.com/pl/kb/syteca-on-premises?hsLang=pl#raporty) - [Monitorowanie urządzeń USB](https://kb.securivy.com/pl/kb/syteca-on-premises?hsLang=pl#monitorowanie-urz%C4%85dze%C5%84-usb) - [Monitoring systemu](https://kb.securivy.com/pl/kb/syteca-on-premises?hsLang=pl#monitoring-systemu) - [Dashboardy](https://kb.securivy.com/pl/kb/syteca-on-premises?hsLang=pl#dashboardy) - [Przeglądanie monitorowanej aktywności użytkowników](https://kb.securivy.com/pl/kb/syteca-on-premises?hsLang=pl#przegl%C4%85danie-monitorowanej-aktywno%C5%9Bci-u%C5%BCytkownik%C3%B3w) - [Inne przewodniki wdrożeniowe](https://kb.securivy.com/pl/kb/syteca-on-premises?hsLang=pl#inne-przewodniki-wdro%C5%BCeniowe) - [Przewodnik instalacji Syteca Master Panel](https://kb.securivy.com/pl/kb/syteca-on-premises?hsLang=pl#przewodnik-instalacji-syteca-master-panel) - [Load balancer](https://kb.securivy.com/pl/kb/syteca-on-premises?hsLang=pl#load-balancer) - [SDK (dla deweloperów)](https://kb.securivy.com/pl/kb/syteca-on-premises?hsLang=pl#sdk-dla-deweloper%C3%B3w) - [Przewodniki integracyjne](https://kb.securivy.com/pl/kb/syteca-on-premises?hsLang=pl#przewodniki-integracyjne) - [Funkcje Syteca](https://kb.securivy.com/pl/kb/syteca-on-premises?hsLang=pl#funkcje-syteca) - [FAQ i Rozwiązywanie problemów](https://kb.securivy.com/pl/kb/syteca-on-premises?hsLang=pl#faq-i-rozwi%C4%85zywanie-problem%C3%B3w) - [Syteca SaaS](https://kb.securivy.com/pl/kb/syteca-saas?hsLang=pl) - [Admin By Request](https://kb.securivy.com/pl/kb/admin-by-request?hsLang=pl) - [Partnerzy](https://kb.securivy.com/pl/kb/partnerzy?hsLang=pl) - [Zgłoszenia Help-Desk](https://hd.securivy.com/tickets) - [Baza Wiedzy Securivy](https://kb.securivy.com/pl/kb) - [Baza Wiedzy Syteca](https://www.syteca.com/docs) [![logo Securivy sp. z o.o.](https://kb.securivy.com/hs-fs/hubfs/Logo%20Securivy/logo%20og%C3%B3lne%20bez%20t%C5%82a%201do2.png?width=200&height=79&name=logo%20og%C3%B3lne%20bez%20t%C5%82a%201do2.png "logo Securivy sp. z o.o.")](https://securivy.com) Securivy sp. z o.o. ul. Gąsiorowskich 4B/99 60-704 Poznań NIP 7792534607 KRS 0000944866 tel. [+48 573 568 234](tel:+48%20573%20568%20234) [biuro@securivy.com](mailto:biuro@securivy.com) [mailto:biuro@securivy.com](mailto:biuro@securivy.com) Baza Wiedzy Securivy Copyright © 2025, Securivy sp. z o.o.