Przeglądasz dokumentację Apigee Edge.
Przejdź do
Dokumentacja Apigee X. informacje.
Krótki opis problemu
Podczas tworzenia aktywnego żądania do interfejsu API przy użyciu SmartDocuments wystąpił błąd z portalu.
Komunikaty o błędach
Częsty błąd w portalu dla programistów to „Wystąpił błąd wewnętrzny. Spróbuj jeszcze raz przesłać prośbę”.
Możliwe przyczyny
Ten błąd może wystąpić, gdy portal dla programistów nie otrzyma odpowiedzi z backendu (smartdocs serwera proxy lub rzeczywistego punktu końcowego).
Diagnostyka
Włącz „Narzędzia dla deweloperów” w przeglądarce i sprawdź kartę Sieć, aby aby określić rzeczywisty błąd.
Typowe błędy i ich typowe przyczyny zostały wymienione w tej tabeli:
|
Błąd |
Typowe przyczyny |
|
ERR_NAME_NOT_RESOLVED |
Niepoprawna konfiguracja serwera proxy SmartDocuments lub zapora sieciowa ograniczenia |
|
Treści mieszane |
Portal skonfigurowany przez HTTP, żądania SmartDocuments HTTP |
|
500 – wewnętrzny błąd serwera |
Przeanalizujmy po kolei każdą z tych przyczyn i pokażmy kolejne kroki, które pozwolą rozwiązać problem.
Błędna konfiguracja serwera proxy SmartDocuments lub zapora sieciowa ograniczenia
Komunikat „ERR_NAME_NOT_RESOLVED” wskazuje, że URL serwera proxy smartdocs jest nieprawidłowo skonfigurowany lub sieć, z której uzyskuje dostęp do portalu nie można nawiązać połączenia z adresem URL serwera proxy smartdocs z powodu ograniczeń zapory sieciowej. Dokumenty inteligentne serwer proxy musi być dostępny z internetu lub z sieci wewnętrznej (w przypadku wewnętrznych interfejsów API).
Rozdzielczość
Zadbaj o to, aby dostęp do serwera proxy Smartdocs można było uzyskać ze wszystkich wymaganych sieci przez wdrożenie z serwera proxy smartdocs do hosta wirtualnego w Edge o nazwie hosta dostępnych w internecie.
Portal skonfigurowany przez HTTPS, żądanie SmartDocuments przez HTTP
Błąd „Mieszana treść” oznacza, że serwer proxy Smartdocs jest jest wywoływana przez HTTP ze strony wczytywanej przez HTTPS.
Rozdzielczość
Udostępnij serwer proxy Smartdocs przez HTTPS, aby rozwiązać problem. Aby to zrobić, wystarczy wdrożyć Serwer proxy smartdocs uwzględnia hosta wirtualnego skonfigurowanego pod kątem użycia TLS/SSL (zwykle jest to „bezpieczny” host wirtualny).
Serwer proxy SmartDocument zwracający wyjątek
Komunikat 500 – wewnętrzny błąd serwera może być spowodowany problemem: używając serwera proxy „smartdocs”. W tym przypadku możesz zauważyć, że serwer proxy Smartdocs zwraca .
Diagnostyka
Użyj narzędzia śledzenia, aby zdiagnozować błędy serwera proxy „smartdocs”, zgodnie z opisem. poniżej. Więcej informacji znajdziesz w artykule Używanie narzędzia Trace.
- Włącz śledzenie serwera proxy „smartdocs” w organizacji „SPRAWDŹ”, aby znaleźć konkretne zasady, które zwracanie wewnętrznego błędu serwera 500.
- Wybierz konkretną zasadę w logu czasu, aby zidentyfikować przyczynę błędu.
Rozdzielczość
Napraw wykryty błąd. Jeśli potrzebujesz wsparcia, skontaktuj się z zespołem pomocy Apigee Edge.
Procesory wiadomości brzegowych nie mogą wywołać opublikowanego punktu końcowego API
500 – wewnętrzny błąd serwera może również wystąpić, gdy procesory wiadomości należące do organizacja hostująca serwer proxy Smartdocs nie może wywołać punktu końcowego API.
Diagnostyka
Użyj narzędzia śledzenia, aby zdiagnozować błędy serwera proxy „smartdocs”, zgodnie z opisem. poniżej. Więcej informacji znajdziesz w artykule Używanie narzędzia Trace.
- Włącz trace dla projektu „smartdocs”. serwera proxy w organizacji „VALIDATE”, aby znaleźć konkretną zasadę. który zwraca wewnętrzny błąd serwera 500.
- W przykładowym logu czasu widocznym powyżej widać, że zasada JavaScript „BuildTargetAPIRequest” nie wykonuje docelowego adresu URL.
- Uzyskiwanie docelowego adresu URL z zasady JavaScript „BuildTargetAPIRequest”.
- Bezpośrednie wywołanie adresu URL z węzłów procesora wiadomości powiązanych z
organizacja „VALIDATE” poniżej:
curl -v <target URL>
- Skoryguj zaobserwowany błąd.
Rozdzielczość
- Sprawdź, czy interfejsy API opublikowane w portalu dla programistów można wywoływać z procesorów wiadomości powiązane z organizacją „VALIDATE” i popraw wszystkie błędy. napotkano problem.
- Jeśli możesz wykonać wywołanie interfejsu API bezpośrednio z procesora wiadomości, prawdopodobnie będziesz też mieć możliwość uruchamiania interfejsu API przy użyciu SmartDocuments.
- Wykonaj wywołanie interfejsu API za pomocą SmartDocuments i sprawdź, czy problem został rozwiązany.