Vous consultez la documentation Apigee Edge.
Accédez à la
documentation Apigee X. info
Problème constaté
Erreur rencontrée lors d'une requête d'API en direct à l'aide de SmartDocs depuis le portail des développeurs.
Messages d'erreur
L'erreur courante observée sur le portail des développeurs est la suivante : Une erreur interne s'est produite. Veuillez réessayer votre requête.
Causes possibles :
Cette erreur peut se produire lorsque le portail des développeurs ne parvient pas à obtenir de réponse du backend (proxy SmartDocs ou point de terminaison réel).
Diagnostic
Activez les "Outils de développement" dans votre navigateur et consultez l'onglet "Réseau" pour identifier l'erreur réelle.
Les erreurs courantes et leurs causes typiques sont répertoriées dans le tableau suivant :
|
Erreur |
Cause(s) typique(s) |
|
ERR_NAME_NOT_RESOLVED |
Proxy SmartDocs mal configuré ou restrictions de pare-feu réseau |
|
Contenu mixte |
|
|
500 - Erreur interne du serveur |
Examinons chacune de ces causes une par une et les étapes à suivre pour résoudre le problème.
Proxy SmartDocs mal configuré ou restrictions de pare-feu réseau
Le message ERR_NAME_NOT_RESOLVED indique que l' URL du proxy SmartDocs est mal configurée ou que le réseau à partir duquel le portail est accessible ne peut pas appeler l'URL du proxy SmartDocs en raison de restrictions de pare-feu. Le proxy SmartDocs doit être accessible depuis Internet ou depuis le réseau interne (pour les API internes).
Solution
Assurez-vous que le proxy SmartDocs est accessible depuis tous les réseaux requis en le déployant le proxy SmartDocs sur un hôte virtuel sur Edge avec un nom d'hôte accessible depuis Internet.
Portail configuré sur HTTPS, requête SmartDocs sur HTTP
L'erreur Contenu mixte indique que le proxy SmartDocs est appelé sur HTTP à partir d'une page chargée sur HTTPS.
Solution
Exposez le proxy SmartDocs sur HTTPS pour résoudre le problème. Pour ce faire, déployez le proxy SmartDocs afin d'inclure un hôte virtuel configuré pour utiliser TLS/SSL (généralement l'hôte virtuel "secure").
Le proxy SmartDocs renvoie une exception
Le message 500 - Erreur interne du serveur peut être causé par un problème avec le proxy "smartdocs". Dans ce cas, vous remarquez que le proxy SmartDocs renvoie cette erreur.
Diagnostic
Utilisez l'outil Trace pour diagnostiquer les erreurs avec le proxy "smartdocs", comme décrit ci-dessous. Pour en savoir plus, consultez la page Utiliser l'outil Trace.
- Activez le traçage pour le proxy smartdocs dans l'organisation VALIDATE afin de localiser la règle spécifique qui renvoie l'erreur interne du serveur 500.
- Sélectionnez la règle spécifique dans le traçage pour identifier la cause de l'erreur.
Solution
Corrigez l'erreur identifiée. Si vous avez besoin d'aide, contactez l'assistance Apigee Edge.
Les processeurs de messages Edge ne peuvent pas appeler le point de terminaison de l'API publiée
L'erreur 500 - Erreur interne du serveur peut également se produire lorsque les processeurs de messages appartenant à l' organisation hébergeant le proxy SmartDocs ne peuvent pas appeler le point de terminaison de l'API.
Diagnostic
Utilisez l'outil Trace pour diagnostiquer les erreurs avec le proxy "smartdocs", comme décrit ci-dessous. Pour en savoir plus, consultez la page Utiliser l'outil Trace.
- Activez le traçage pour le proxy smartdocs dans l'organisation VALIDATE afin de localiser la règle spécifique qui renvoie l'erreur interne du serveur 500.
- Dans l'exemple de traçage d'interface utilisateur présenté ci-dessus, la règle JavaScript “BuildTargetAPIRequest” ne parvient pas à exécuter l'URL cible.
- Obtenez l'URL cible à partir de la règle JavaScript “BuildTargetAPIRequest”.
- Effectuez un appel direct à l'URL à partir des nœuds du processeur de messages associés à
l'organisation “VALIDATE”, comme indiqué ci-dessous :
curl -v <target URL>
- Corrigez toute erreur observée.
Solution
- Assurez-vous que les API publiées sur le portail des développeurs peuvent être appelées à partir des processeurs de messages associés à l'organisation « VALIDATE » et corrigez toutes les erreurs rencontrées.
- Si vous parvenez à exécuter l'appel d'API directement à partir du processeur de messages, il est très probable que vous puissiez également exécuter l'API via SmartDocs.
- Exécutez l'appel d'API via SmartDocs et vérifiez si le problème est résolu.