Stai visualizzando la documentazione di Apigee Edge.
Consulta la
documentazione di Apigee X. info
Sintomo
Si è verificato un errore durante l'invio di una richiesta API live utilizzando SmartDocs dal portale per sviluppatori.
Messaggi di errore
L'errore comune visualizzato nel portale per sviluppatori è "Si è verificato un errore interno. Riprova a inviare la richiesta".
Possibili cause
Questo errore può verificarsi quando il portale per sviluppatori non riesce a ricevere una risposta dal backend (proxy SmartDocs o endpoint effettivo).
Diagnosi
Abilita "Strumenti per sviluppatori" nel browser e controlla la scheda Rete per identificare l'errore effettivo.
Gli errori comuni e le relative cause tipiche sono elencati nella tabella seguente:
|
Errore |
Cause tipiche |
|
ERR_NAME_NOT_RESOLVED |
Proxy SmartDocs configurato in modo errato o restrizioni del firewall di rete |
|
Contenuto misto |
Portale configurato tramite HTTPs, richiesta SmartDocs tramite HTTP |
|
500 - Errore interno del server |
Esaminiamo ciascuna di queste cause una alla volta e i passaggi per risolvere il problema.
Proxy SmartDocs configurato in modo errato o restrizioni del firewall di rete
Il messaggio "ERR_NAME_NOT_RESOLVED" indica che l' URL del proxy SmartDocs è configurato in modo errato o che la rete da cui si accede al portale non è in grado di effettuare una chiamata all'URL del proxy SmartDocs a causa delle restrizioni del firewall. Il proxy SmartDocs deve essere accessibile da internet o dalla rete interna (per le API interne).
Risoluzione
Assicurati che sia possibile accedere al proxy SmartDocs da tutte le reti richieste eseguendo il deployment del proxy SmartDocs su un host virtuale su Edge con un nome host accessibile da internet.
Portale configurato tramite HTTPS, richiesta SmartDocs tramite HTTP
L'errore "Contenuto misto" indica che il proxy SmartDocs viene chiamato tramite HTTP da una pagina caricata tramite HTTPS.
Risoluzione
Per risolvere il problema, esponi il proxy SmartDocs tramite HTTPS. Per farlo, esegui il deployment del proxy SmartDocs in modo da includere un host virtuale configurato per l'utilizzo di TLS/SSL (in genere l'host virtuale "sicuro").
Il proxy SmartDocs restituisce un'eccezione
Il messaggio 500 - Errore interno del server può essere causato da un problema con il proxy "smartdocs". In questo caso, noterai che il proxy SmartDocs restituisce questo errore.
Diagnosi
Utilizza lo strumento Trace per diagnosticare gli errori con il proxy "smartdocs", come descritto di seguito. Per ulteriori informazioni, consulta la sezione Utilizzare lo strumento Trace.
- Abilita la traccia per il proxy “smartdocs” nell' organizzazione “VALIDATE” per individuare la policy specifica che restituisce l'errore interno del server 500.
- Seleziona la policy specifica nella traccia per identificare la causa dell'errore.
Risoluzione
Correggi l'errore identificato. Se hai bisogno di assistenza, contatta l'assistenza Apigee Edge.
I processori di messaggi Edge non sono in grado di chiamare l'endpoint API pubblicato
L'errore interno del server 500 può verificarsi anche quando i processori di messaggi appartenenti all' organizzazione che ospita il proxy SmartDocs non sono in grado di chiamare l'endpoint API.
Diagnosi
Utilizza lo strumento Trace per diagnosticare gli errori con il proxy "smartdocs", come descritto di seguito. Per ulteriori informazioni, consulta la sezione Utilizzare lo strumento Trace.
- Abilita traccia per il proxy “smartdocs” nell'organizzazione “VALIDATE” per individuare la policy specifica che restituisce l'errore interno del server 500.
- Nella traccia dell'interfaccia utente di esempio mostrata sopra, si nota che la policy JavaScript “BuildTargetAPIRequest” non riesce a eseguire l'URL di destinazione.
- Ottieni l'URL di destinazione dalla policy JavaScript “BuildTargetAPIRequest”.
- Effettua una chiamata diretta all'URL dai nodi del processore di messaggi associati a
“VALIDATE” org, come mostrato di seguito:
curl -v <target URL>
- Correggi eventuali errori osservati.
Risoluzione
- Assicurati che le API pubblicate nel portale per sviluppatori possano essere richiamate dai processori di messaggi associati all'organizzazione “VALIDATE” e correggi eventuali errori riscontrati.
- Se riesci a eseguire la chiamata API direttamente dal processore di messaggi, è molto probabile che tu possa eseguire l'API anche tramite SmartDocs.
- Esegui la chiamata API tramite SmartDocs e verifica se il problema è stato risolto.