Przejdź do głównej zawartości

Rozwiązywanie problemów z połączeniem REST-API

  • Zaktualizowano

Istnieje wiele zapytań, które można wykonać za pomocą CMD (Wiersz poleceń), aby przetestować łączność REST-API. Nie są wymagane prawa administratora. 

Wykonaj zapytania na maszynach, na których próbujesz nawiązać połączenie. W zależności od zastosowania mogą to być maszyny z uruchomionym PowerBi, Excelem, Twoim Serwerem Confluence lub dowolnym innym produktem firm trzecich.

 

Zapytania o podstawową łączność

On premise - produkt BOC w Twojej własnej infrastrukturze

curl https://<SERVER_NAME>:<PORT>/<PRODUCT><VERSION>/rest/connection

Chmura (SaaS) - produkt BOC hostowany przez nas

curl https://example-pp123456.boc-cloud.com/rest/connection

Pozytywna odpowiedź:

REST Connection Service Evaluation invoked @ Mon Mar 10 15:50:36 CET 2025

Jeśli to zapytanie zakończyło się powodzeniem, możesz przejść do kolejnych testów.


Negatywna odpowiedź 1: 

--connect-timeout

Możliwy problem z siecią. Polecenie REST nie dociera do Twojego serwera Apache Tomcat.

 

Negatywna odpowiedź 2: 

Każda inna odpowiedź wskazuje na możliwy serwer proxy pomiędzy Twoją maszyną a serwerem Tomcat.

W skład tych elementów mogą wchodzić:

  • Reverse Proxy
  • Zapora sieciowa (Firewall)
  • IIS

Pliki dziennika poszczególnych komponentów w Twojej infrastrukturze mogą dostarczyć wskazówek do rozwiązania problemu.


Zapytania o podstawową autoryzację

On premise - produkt BOC w Twojej własnej infrastrukturze

curl -u "username:password" https://<SERVER_NAME>:<PORT>/<PRODUCT><VERSION>/rest/connection/auth

Chmura (SaaS) - produkt BOC hostowany przez nas

curl -u "username:password" https://example-pp123456.boc-cloud.com/rest/connection/auth

Ważne: Basic Auth musi być włączona i skonfigurowana, aby to działało. Test działa tylko z lokalnymi, nietechnicznymi użytkownikami: Basic Authentication | BOC Developer Portal
 
ADONIS 16, ADOIT 17 oraz ADOGRC 13 i nowsze: Basic Auth Guide
Przed ADONIS 16, ADOIT 17 oraz ADOGRC 13: Basic Auth Guide

 

Pozytywna odpowiedź:

Authorized Access Granted @ Mon Mar 10 15:54:54 CET 2025


Negatywna odpowiedź 1: 

Unauthorized : basic_auth_invalid 

Możliwe przyczyny:

  • Niepoprawne dane użytkownika
  • Użyto użytkownika IDM lub technicznego
  • Basic Auth nie jest włączona/nie jest w pełni skonfigurowana
     

Negatywna odpowiedź 2: 

basic_auth_not_allowed

Możliwa przyczyna:

  • Twój adres IP nie znajduje się na liście dozwolonych. Zobacz Basic Auth Guide po więcej szczegółów.


Zapytania o repozytorium

On premise - produkt BOC w Twojej własnej infrastrukturze

curl -u "username:password" https://<SERVER_NAME>:<PORT>/<PRODUCT><VERSION>/rest/<restversion>/repos

Chmura (SaaS) - produkt BOC hostowany przez nas

curl -u "username:password" https://example-pp123456.boc-cloud.com/rest/<restversion>/repos


Pozytywna odpowiedź:

{"repos":[{"id":"{163197e6-b923-495b-a1be-814af464a620}","name":"Standard Repository"}]}


Negatywna odpowiedź 1:

basic_auth_invalid

Możliwa przyczyna:

  • Wprowadzono niepoprawne dane uwierzytelniające


Negatywna odpowiedź 2: 

{"repos":[]}

Możliwa przyczyna:

  • Brak repozytoriów przypisanych do użytkownika

 

Dalsze informacje o REST-API

Welcome to the BOC Developer Portal | BOC Developer Portal


 

Powiązane artykuły